# Overview

## Agents

Agent catalog (list, get, publish, unregister — caller-plugged registry).

## Operations

GET

[/v1/agents](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentslist.md)

POST

[/v1/agents](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentspublish.md)

GET

[/v1/agents/{agentId}](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsget.md)

GET

[/v1/agents/{agentId}/versions](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentslistversions.md)

POST

[/v1/agents/{agentId}/versions](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsderiveversion.md)

GET

[/v1/agents/{agentId}/versions/{version}](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsgetversion.md)

POST

[/v1/agents/{agentId}/versions/{version}/unregister](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsunregister.md)

POST

[/v1/agents/{agentId}/versions/{version}/reinstate](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsreinstateversion.md)

GET

[/v1/agents/{agentId}/live](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsliveresolve.md)

GET

[/v1/agents/{agentId}/live-versions](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentslivelist.md)

GET

[/v1/agents/{agentId}/promotions](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentspromotionslist.md)

POST

[/v1/agents/{agentId}/promotions](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentspromotionscreate.md)

POST

[/v1/agents/{agentId}/promotions/check](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentspromotionscheck.md)

GET

[/v1/agents/{agentId}/gate-policy](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsgatepolicyresolve.md)

GET

[/v1/agents/{agentId}/promotions/{promotionId}](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentspromotionsget.md)

POST

[/v1/agents/{agentId}/live/rollback](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsliverollback.md)

POST

[/v1/agents/{agentId}/live/unpin](https://docs.kindgi.com/v0.1.8/reference/api/operations/agentsliveunpin.md)