Delete Config Version

Catalog prerequisites

This operates on the database-backed component catalog configured on AgentOS, not on the in-code agents, teams or workflows lists. It requires a supported synchronous BaseDb adapter with component methods.

Published components can be readable across scoped owners, while writes remain owner-scoped; a visible foreign or shared row can still reject a write with 403. Draft versions require preview access. Saving configuration does not validate model credentials, run tools or deploy a service.

Delete a draft version

Only draft versions can be tombstoned. Deleting a published version returns 400. Deleting the last visible version, or a version pinned by an active parent dependency, can return 409. Successful deletion returns 204.

The version number is retained and never recycled. To archive the whole component, use Delete Component.

DELETE/components/{component_id}/configs/{version}

Delete a specific draft config version. Cannot delete published or current configs.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

component_id*Component Id

Component ID

version*Version

Version number

Response Body

application/json

application/json

application/json

application/json

application/json

curl --request DELETE 'https://example.com/components/string/configs/0'
Empty