Extensions
AGH Extensions HTTP endpoints.
- Audience
- Operators running durable agent work
- Focus
- API Reference guidance shaped for scanability, day-two clarity, and operator context.
curl -X GET "https://example.com/api/extensions"{
"extensions": [
{
"actions": [
"string"
],
"bundles": [
{
"description": "string",
"name": "string",
"profiles": [
"string"
]
}
],
"capabilities": [
"string"
],
"daemon_running": true,
"diagnostics": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
],
"enabled": true,
"health": "string",
"health_message": "string",
"last_error": "string",
"missing_env": [
"string"
],
"name": "string",
"pid": 0,
"provenance": {
"allow_unverified": true,
"checksum_sha256": "string",
"checksum_verified": true,
"installed_at": "2019-08-24T14:15:22Z",
"installed_by": "string",
"installed_from": "string",
"permissions": [
"string"
],
"registry_tier": "string",
"slug": "string",
"source_url": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"requires_env": [
"string"
],
"source": "string",
"state": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"type": "string",
"uptime_seconds": 0,
"version": "string"
}
]
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensionsRequest Body
application/json
JSON request body
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/extensions" \ -H "Content-Type: application/json" \ -d '{}'{
"extension": {
"actions": [
"string"
],
"bundles": [
{
"description": "string",
"name": "string",
"profiles": [
"string"
]
}
],
"capabilities": [
"string"
],
"daemon_running": true,
"diagnostics": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
],
"enabled": true,
"health": "string",
"health_message": "string",
"last_error": "string",
"missing_env": [
"string"
],
"name": "string",
"pid": 0,
"provenance": {
"allow_unverified": true,
"checksum_sha256": "string",
"checksum_verified": true,
"installed_at": "2019-08-24T14:15:22Z",
"installed_by": "string",
"installed_from": "string",
"permissions": [
"string"
],
"registry_tier": "string",
"slug": "string",
"source_url": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"requires_env": [
"string"
],
"source": "string",
"state": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"type": "string",
"uptime_seconds": 0,
"version": "string"
}
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensions/marketplaceQuery Parameters
Search query
Marketplace source filter
Maximum number of results
int32Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/extensions/marketplace"{
"extensions": [
{
"author": "string",
"description": "string",
"downloads": 0,
"name": "string",
"slug": "string",
"source": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"type": "string",
"version": "string"
}
]
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensions/{name}Path Parameters
Extension name
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/extensions/string"{
"extension": {
"actions": [
"string"
],
"bundles": [
{
"description": "string",
"name": "string",
"profiles": [
"string"
]
}
],
"capabilities": [
"string"
],
"daemon_running": true,
"diagnostics": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
],
"enabled": true,
"health": "string",
"health_message": "string",
"last_error": "string",
"missing_env": [
"string"
],
"name": "string",
"pid": 0,
"provenance": {
"allow_unverified": true,
"checksum_sha256": "string",
"checksum_verified": true,
"installed_at": "2019-08-24T14:15:22Z",
"installed_by": "string",
"installed_from": "string",
"permissions": [
"string"
],
"registry_tier": "string",
"slug": "string",
"source_url": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"requires_env": [
"string"
],
"source": "string",
"state": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"type": "string",
"uptime_seconds": 0,
"version": "string"
}
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensions/{name}Path Parameters
Extension name
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/extensions/string"{
"extension": {
"name": "string",
"path": "string",
"status": "string"
}
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensions/{name}Path Parameters
Extension name
Request Body
application/json
JSON request body
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/api/extensions/string" \ -H "Content-Type: application/json" \ -d '{}'{
"update": {
"current_version": "string",
"latest_version": "string",
"name": "string",
"path": "string",
"registry": "string",
"slug": "string",
"status": "string"
}
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensions/{name}/disablePath Parameters
Extension name
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/extensions/string/disable"{
"extension": {
"actions": [
"string"
],
"bundles": [
{
"description": "string",
"name": "string",
"profiles": [
"string"
]
}
],
"capabilities": [
"string"
],
"daemon_running": true,
"diagnostics": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
],
"enabled": true,
"health": "string",
"health_message": "string",
"last_error": "string",
"missing_env": [
"string"
],
"name": "string",
"pid": 0,
"provenance": {
"allow_unverified": true,
"checksum_sha256": "string",
"checksum_verified": true,
"installed_at": "2019-08-24T14:15:22Z",
"installed_by": "string",
"installed_from": "string",
"permissions": [
"string"
],
"registry_tier": "string",
"slug": "string",
"source_url": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"requires_env": [
"string"
],
"source": "string",
"state": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"type": "string",
"uptime_seconds": 0,
"version": "string"
}
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensions/{name}/enablePath Parameters
Extension name
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/extensions/string/enable"{
"extension": {
"actions": [
"string"
],
"bundles": [
{
"description": "string",
"name": "string",
"profiles": [
"string"
]
}
],
"capabilities": [
"string"
],
"daemon_running": true,
"diagnostics": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
],
"enabled": true,
"health": "string",
"health_message": "string",
"last_error": "string",
"missing_env": [
"string"
],
"name": "string",
"pid": 0,
"provenance": {
"allow_unverified": true,
"checksum_sha256": "string",
"checksum_verified": true,
"installed_at": "2019-08-24T14:15:22Z",
"installed_by": "string",
"installed_from": "string",
"permissions": [
"string"
],
"registry_tier": "string",
"slug": "string",
"source_url": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"requires_env": [
"string"
],
"source": "string",
"state": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"type": "string",
"uptime_seconds": 0,
"version": "string"
}
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}/api/extensions/{name}/provenancePath Parameters
Extension name
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/extensions/string/provenance"{
"provenance": {
"allow_unverified": true,
"checksum_sha256": "string",
"checksum_verified": true,
"installed_at": "2019-08-24T14:15:22Z",
"installed_by": "string",
"installed_from": "string",
"permissions": [
"string"
],
"registry_tier": "string",
"slug": "string",
"source_url": "string",
"trust": {
"allow_unverified": true,
"checksum_verified": true,
"decision": "string",
"registry_tier": "string",
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
},
"warnings": [
{
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
}
]
}
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}