DOM360
Agentes

Criar um ramo

POST
/agents/{agent_id}/branches

Cria uma variação a partir de uma versão E entra nela (as duas coisas são uma operação só). Devolve o ramo criado, já como a linha atual. Aceita Idempotency-Key (opcional).

Autorização

bearer agent-config:write
Autorizaçã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 cabeçalho

Idempotency-Key?|

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 /branches.

Corpo da resposta

application/json

application/json

curl -X POST "https://example.com/agents/string/branches" \  -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \  -H "Content-Type: application/json" \  -d '{    "from_version_id": "b43b4c91-8c43-48b3-91e7-00ec1cedc2ab",    "name": "string"  }'
{  "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"}