Agentes
Apagar o histórico de versões
Apaga todo o grafo de versões, ramos e anotações do agente, deixando o corpo vivo intacto. Exige confirm=LIMPAR na query. Devolve o que foi removido.
Autorização
bearer agent-config:writeAutorizaçãoBearer <token>
Credencial 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
agent_id*string
Id do agente
Parâmetros de consulta
confirm*string
Deve ser exatamente LIMPAR.
Corpo da resposta
application/json
application/json
curl -X DELETE "https://example.com/agents/string/versions?confirm=string"{ "branches_removed": 0, "cleared": true, "notes_removed": 0, "versions_removed": 0}