Agentes
Alterar um ramo
Entra num ramo: is_current: true faz o agente entrar nesta linha (checkout); false é 422 (para sair de uma linha, entre em outra). Devolve o ramo atualizado. Um ramo inexistente responde 404.
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
branch_id*string
Id do ramo
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
O corpo de PATCH /branches/{branch_id}: só o checkout
(is_current: true), como fixa a D9 — renomear não tem consumidor.
Corpo da resposta
application/json
application/json
curl -X PATCH "https://example.com/agents/string/branches/string" \ -H "Content-Type: application/json" \ -d '{}'{ "created_at": "string", "head_commit_id": "2f72c856-2afc-4ed3-85de-7393d4ab7fbc", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "is_current": true, "is_default": true, "name": "string"}