Restaurar ou promover uma versão
Cria uma nova versão a partir de outra. kind=restore recria o corpo de uma versão antiga como novo HEAD; kind=promote anexa o corpo de um ramo de origem sobre outro. Devolve a versão resultante. Aceita Idempotency-Key (opcional). O 201 não traz Location: a versão não tem rota de item na v3 — vem inteira no corpo e aparece em GET /agents/{agent_id}/versions.
Autorização
bearer agent-config:writeCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: agent-config:write
Parâmetros de caminho
Id do agente
Parâmetros de cabeçalho
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
O corpo de POST /versions: uma restauração ou uma promoção, distinguidas
pelo campo kind. Uma só rota concentra as duas mutações que criam uma
versão a partir de outra.
Recria o corpo de uma versão antiga como um novo HEAD.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/agents/string/versions" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "kind": "restore", "version_id": "9e94c502-ca41-4342-a7f7-af96b444512c" }'{ "author_id": "78424c75-5c41-4b25-9735-3c9f7d05c59e", "created_at": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "is_current": true, "label": "string", "message": "string", "note_count": 0, "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef"}