VolundOS
Referência da APIExecução

Decidir o plano de um run

Aprova ou reprova o plano que um turno com `plan_mode: true` propôs. O `request_id` é o do evento `awaiting_input` com `kind: "plan"`, ou o de `pending_plan` em GET /v1/runs/{runId}. Aprovar grava a decisão, desliga o modo de plano e retoma a conversa para executar o plano, em segundo plano; o desfecho sai em GET /v1/runs/{runId}. O turno que propôs o plano precisa ter terminado: enquanto ele termina, a decisão responde 409 `turn_still_running` sem gravar nada, e quem chama tenta de novo em alguns segundos. Reprovar grava a recusa com a `note` e devolve a conversa ociosa, sem retomar o agente: o replanejamento é um turno novo de quem chamou, por POST /v1/runs/{runId}/continue ou /stream com `plan_mode: true` e a nota como `input`. Decide quem é aprovador do pedido ou quem configura o agente, avaliado como a pessoa dona da chave. Exige o escopo runs:execute.

Atualizado em 04 de novembro de 2026
POST
/v1/runs/{runId}/plan

Authorization

chaveDeApi
AuthorizationBearer <token>

Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.

In: header

Path Parameters

runId*string

Identificador do run. É o mesmo da conversa: um run continua na mesma thread.

Header Parameters

Volund-Org?string

Slug (ou id) de uma organização cliente do parceiro dono da chave. Aceito só em GET /v1/agents, POST /v1/agents/{agentId}/run, POST /v1/agents/{agentId}/stream, POST /v1/agents/{agentId}/threads, POST /v1/runs/{runId}/continue, GET /v1/runs/{runId}, POST /v1/runs/{runId}/stream, POST /v1/runs/{runId}/stop, POST /v1/runs/{runId}/plan e POST /v1/runs/{runId}/prewarm, e só com o escopo partner:execute: a operação roda dentro da organização cliente, como a identidade de sistema dela, sobre as cópias gerenciadas dos agentes do parceiro. Qualquer outra rota responde 400 org_header_not_supported. Organização que não existe ou não é cliente deste parceiro: 404 client_not_found.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/runs/string/plan" \  -H "Content-Type: application/json" \  -d '{    "request_id": "string",    "decision": "approve"  }'
{  "run_id": "string",  "request_id": "string",  "decision": "approved",  "resumed": true}