VolundOS
Referência da APIExecução

Disparar um agente

Sem callback_url, a conexão fica aberta e a resposta traz o texto final. Com callback_url, a resposta é imediata (202) e o resultado é enviado àquele endereço quando o run termina. Exige o escopo runs:execute.

Atualizado em 13 de agosto de 2026
POST
/v1/agents/{agentId}/run

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

agentId*string

Identificador do agente.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Ao menos um entre input e files precisa vir preenchido.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agents/string/run" \  -H "Content-Type: application/json" \  -d '{}'
{  "run_id": "string",  "thread_id": "string",  "status": "completed",  "output": "string",  "usage": {},  "transcript_url": "string"}

Referência da API

Como chamar o VolundOS do seu próprio código — autenticação, escopos e o que cada operação faz.

Disparar um agente recebendo o passo a passo

Responde text/event-stream e emite os eventos à medida que o agente pensa, chama ferramentas e escreve. A preparação do run é idêntica à do disparo comum. Exige o escopo runs:execute.