Skip to content

Extensions

Compozy Extensions HTTP endpoints.

For people running agent work31 pages in this section

List installed extensions

GET/api/extensions

Query Parameters

workspace?string

Operator workspace reference; omit for the global instance

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/extensions"
{  "extensions": [    {      "bundles": [        {          "description": "string",          "name": "string",          "profiles": [            "string"          ]        }      ],      "capabilities": [        "string"      ],      "consecutive_failures": 0,      "daemon_running": true,      "dev": 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"        }      ],      "digest_matched": true,      "enabled": true,      "failure_code": "string",      "generation_hash": "string",      "health": "string",      "health_message": "string",      "last_error": "string",      "marketplace": {        "author": "string",        "description": "string",        "downloads": 0,        "entry_id": "string",        "install_slug": "string",        "installed": true,        "installed_name": "string",        "installed_version": "string",        "kind": "string",        "manage_path": "string",        "name": "string",        "published_at": "2019-08-24T14:15:22Z",        "source": "string",        "tier": "string",        "transport": "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"            }          ]        },        "update_available": true,        "updated_at": "2019-08-24T14:15:22Z",        "version": "string"      },      "missing_env": [        "string"      ],      "name": "string",      "origin_path": "string",      "overrides_published": true,      "permissions": [        "string"      ],      "pid": 0,      "provenance": {        "allow_unverified": true,        "archive_digest_sha256": "string",        "catalog_entry_id": "string",        "checksum_sha256": "string",        "checksum_verified": true,        "digest_matched": 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"          }        ]      },      "remote_version": "string",      "requires_env": [        "string"      ],      "restart_backoff_ms": 0,      "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",      "update_available": true,      "uptime_seconds": 0,      "version": "string",      "workspace_id": "string"    }  ]}

Install a local or marketplace extension

POST/api/extensions

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

curl -X POST "https://example.com/api/extensions" \  -H "Content-Type: application/json" \  -d '{    "ref": "string",    "source": "string"  }'
{  "extension": {    "bundles": [      {        "description": "string",        "name": "string",        "profiles": [          "string"        ]      }    ],    "capabilities": [      "string"    ],    "consecutive_failures": 0,    "daemon_running": true,    "dev": 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"      }    ],    "digest_matched": true,    "enabled": true,    "failure_code": "string",    "generation_hash": "string",    "health": "string",    "health_message": "string",    "last_error": "string",    "marketplace": {      "author": "string",      "description": "string",      "downloads": 0,      "entry_id": "string",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "string",      "manage_path": "string",      "name": "string",      "published_at": "2019-08-24T14:15:22Z",      "source": "string",      "tier": "string",      "transport": "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"          }        ]      },      "update_available": true,      "updated_at": "2019-08-24T14:15:22Z",      "version": "string"    },    "missing_env": [      "string"    ],    "name": "string",    "origin_path": "string",    "overrides_published": true,    "permissions": [      "string"    ],    "pid": 0,    "provenance": {      "allow_unverified": true,      "archive_digest_sha256": "string",      "catalog_entry_id": "string",      "checksum_sha256": "string",      "checksum_verified": true,      "digest_matched": 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"        }      ]    },    "remote_version": "string",    "requires_env": [      "string"    ],    "restart_backoff_ms": 0,    "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",    "update_available": true,    "uptime_seconds": 0,    "version": "string",    "workspace_id": "string"  }}

List active extension-contributed commands

GET/api/extensions/commands

Query Parameters

extension?string

Filter by exact extension name

workspace?string

Operator workspace reference; agent callers use trusted session scope

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/extensions/commands"
{  "commands": [    {      "approval_required": true,      "extension": "string",      "flags": [        {          "default": null,          "enum": [            "string"          ],          "field": "string",          "maximum": 0,          "minimum": 0,          "name": "string",          "nullable": true,          "repeatable": true,          "required": true,          "type": "string"        }      ],      "risk_class": "read",      "summary": "string",      "tool_id": "string",      "verb": "string",      "examples": [        {          "type": "string"        }      ]    }  ],  "groups": [    {      "extension": "string",      "path": "string",      "summary": "string"    }  ]}
POST/api/extensions/dev

Query Parameters

workspace?string

Operator workspace reference; agent callers use trusted session scope

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

curl -X POST "https://example.com/api/extensions/dev" \  -H "Content-Type: application/json" \  -d '{    "generation_hash": "string",    "origin_path": "string"  }'
{  "extension": {    "bundles": [      {        "description": "string",        "name": "string",        "profiles": [          "string"        ]      }    ],    "capabilities": [      "string"    ],    "consecutive_failures": 0,    "daemon_running": true,    "dev": 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"      }    ],    "digest_matched": true,    "enabled": true,    "failure_code": "string",    "generation_hash": "string",    "health": "string",    "health_message": "string",    "last_error": "string",    "marketplace": {      "author": "string",      "description": "string",      "downloads": 0,      "entry_id": "string",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "string",      "manage_path": "string",      "name": "string",      "published_at": "2019-08-24T14:15:22Z",      "source": "string",      "tier": "string",      "transport": "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"          }        ]      },      "update_available": true,      "updated_at": "2019-08-24T14:15:22Z",      "version": "string"    },    "missing_env": [      "string"    ],    "name": "string",    "origin_path": "string",    "overrides_published": true,    "permissions": [      "string"    ],    "pid": 0,    "provenance": {      "allow_unverified": true,      "archive_digest_sha256": "string",      "catalog_entry_id": "string",      "checksum_sha256": "string",      "checksum_verified": true,      "digest_matched": 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"        }      ]    },    "remote_version": "string",    "requires_env": [      "string"    ],    "restart_backoff_ms": 0,    "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",    "update_available": true,    "uptime_seconds": 0,    "version": "string",    "workspace_id": "string"  }}

Get one installed extension

GET/api/extensions/{name}

Path Parameters

name*string

Extension name

Query Parameters

workspace?string

Operator workspace reference; omit for the global instance

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/extensions/string"
{  "extension": {    "bundles": [      {        "description": "string",        "name": "string",        "profiles": [          "string"        ]      }    ],    "capabilities": [      "string"    ],    "consecutive_failures": 0,    "daemon_running": true,    "dev": 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"      }    ],    "digest_matched": true,    "enabled": true,    "failure_code": "string",    "generation_hash": "string",    "health": "string",    "health_message": "string",    "last_error": "string",    "marketplace": {      "author": "string",      "description": "string",      "downloads": 0,      "entry_id": "string",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "string",      "manage_path": "string",      "name": "string",      "published_at": "2019-08-24T14:15:22Z",      "source": "string",      "tier": "string",      "transport": "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"          }        ]      },      "update_available": true,      "updated_at": "2019-08-24T14:15:22Z",      "version": "string"    },    "missing_env": [      "string"    ],    "name": "string",    "origin_path": "string",    "overrides_published": true,    "permissions": [      "string"    ],    "pid": 0,    "provenance": {      "allow_unverified": true,      "archive_digest_sha256": "string",      "catalog_entry_id": "string",      "checksum_sha256": "string",      "checksum_verified": true,      "digest_matched": 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"        }      ]    },    "remote_version": "string",    "requires_env": [      "string"    ],    "restart_backoff_ms": 0,    "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",    "update_available": true,    "uptime_seconds": 0,    "version": "string",    "workspace_id": "string"  }}

Remove one managed extension

DELETE/api/extensions/{name}

Path Parameters

name*string

Extension name

Query Parameters

workspace?string

Operator workspace reference; omit for the global instance

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",    "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"      }    ]  }}

Update one marketplace-installed extension

PUT/api/extensions/{name}

Path Parameters

name*string

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",    "error": {      "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"    },    "latest_version": "string",    "name": "string",    "path": "string",    "registry": "string",    "slug": "string",    "status": "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"      }    ]  }}

Disable an installed extension

POST/api/extensions/{name}/disable

Path Parameters

name*string

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": {    "bundles": [      {        "description": "string",        "name": "string",        "profiles": [          "string"        ]      }    ],    "capabilities": [      "string"    ],    "consecutive_failures": 0,    "daemon_running": true,    "dev": 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"      }    ],    "digest_matched": true,    "enabled": true,    "failure_code": "string",    "generation_hash": "string",    "health": "string",    "health_message": "string",    "last_error": "string",    "marketplace": {      "author": "string",      "description": "string",      "downloads": 0,      "entry_id": "string",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "string",      "manage_path": "string",      "name": "string",      "published_at": "2019-08-24T14:15:22Z",      "source": "string",      "tier": "string",      "transport": "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"          }        ]      },      "update_available": true,      "updated_at": "2019-08-24T14:15:22Z",      "version": "string"    },    "missing_env": [      "string"    ],    "name": "string",    "origin_path": "string",    "overrides_published": true,    "permissions": [      "string"    ],    "pid": 0,    "provenance": {      "allow_unverified": true,      "archive_digest_sha256": "string",      "catalog_entry_id": "string",      "checksum_sha256": "string",      "checksum_verified": true,      "digest_matched": 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"        }      ]    },    "remote_version": "string",    "requires_env": [      "string"    ],    "restart_backoff_ms": 0,    "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",    "update_available": true,    "uptime_seconds": 0,    "version": "string",    "workspace_id": "string"  }}

Enable an installed extension

POST/api/extensions/{name}/enable

Path Parameters

name*string

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": {    "bundles": [      {        "description": "string",        "name": "string",        "profiles": [          "string"        ]      }    ],    "capabilities": [      "string"    ],    "consecutive_failures": 0,    "daemon_running": true,    "dev": 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"      }    ],    "digest_matched": true,    "enabled": true,    "failure_code": "string",    "generation_hash": "string",    "health": "string",    "health_message": "string",    "last_error": "string",    "marketplace": {      "author": "string",      "description": "string",      "downloads": 0,      "entry_id": "string",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "string",      "manage_path": "string",      "name": "string",      "published_at": "2019-08-24T14:15:22Z",      "source": "string",      "tier": "string",      "transport": "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"          }        ]      },      "update_available": true,      "updated_at": "2019-08-24T14:15:22Z",      "version": "string"    },    "missing_env": [      "string"    ],    "name": "string",    "origin_path": "string",    "overrides_published": true,    "permissions": [      "string"    ],    "pid": 0,    "provenance": {      "allow_unverified": true,      "archive_digest_sha256": "string",      "catalog_entry_id": "string",      "checksum_sha256": "string",      "checksum_verified": true,      "digest_matched": 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"        }      ]    },    "remote_version": "string",    "requires_env": [      "string"    ],    "restart_backoff_ms": 0,    "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",    "update_available": true,    "uptime_seconds": 0,    "version": "string",    "workspace_id": "string"  }}

Read or follow redacted extension logs

GET/api/extensions/{name}/logs

Path Parameters

name*string

Extension name

Query Parameters

workspace?string

Operator workspace reference; omit for the global instance

follow?string

Stream new entries as extension_log SSE events

after?string

Return entries after this monotonic sequence

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/extensions/string/logs"
{  "logs": [    {      "generation_hash": "string",      "message": "string",      "sequence": 0,      "timestamp": "2019-08-24T14:15:22Z"    }  ]}

Get extension provenance and trust evidence

GET/api/extensions/{name}/provenance

Path Parameters

name*string

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,    "archive_digest_sha256": "string",    "catalog_entry_id": "string",    "checksum_sha256": "string",    "checksum_verified": true,    "digest_matched": 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"      }    ]  }}

Reload a workspace extension from an immutable generation

POST/api/extensions/{name}/reload

Path Parameters

name*string

Extension name

Query Parameters

workspace?string

Operator workspace reference; agent callers use trusted session scope

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

curl -X POST "https://example.com/api/extensions/string/reload" \  -H "Content-Type: application/json" \  -d '{    "generation_hash": "string"  }'
{  "extension": {    "bundles": [      {        "description": "string",        "name": "string",        "profiles": [          "string"        ]      }    ],    "capabilities": [      "string"    ],    "consecutive_failures": 0,    "daemon_running": true,    "dev": 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"      }    ],    "digest_matched": true,    "enabled": true,    "failure_code": "string",    "generation_hash": "string",    "health": "string",    "health_message": "string",    "last_error": "string",    "marketplace": {      "author": "string",      "description": "string",      "downloads": 0,      "entry_id": "string",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "string",      "manage_path": "string",      "name": "string",      "published_at": "2019-08-24T14:15:22Z",      "source": "string",      "tier": "string",      "transport": "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"          }        ]      },      "update_available": true,      "updated_at": "2019-08-24T14:15:22Z",      "version": "string"    },    "missing_env": [      "string"    ],    "name": "string",    "origin_path": "string",    "overrides_published": true,    "permissions": [      "string"    ],    "pid": 0,    "provenance": {      "allow_unverified": true,      "archive_digest_sha256": "string",      "catalog_entry_id": "string",      "checksum_sha256": "string",      "checksum_verified": true,      "digest_matched": 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"        }      ]    },    "remote_version": "string",    "requires_env": [      "string"    ],    "restart_backoff_ms": 0,    "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",    "update_available": true,    "uptime_seconds": 0,    "version": "string",    "workspace_id": "string"  }}

Providers

Compozy Providers HTTP endpoints.

Vault

Compozy Vault HTTP endpoints.