VolundOS
Referência da APIExecução

Disparar um agente

Três modos. Sem `callback_url` e sem `async`, 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. Com `async: true`, a resposta é imediata (202) e nada é enviado — o desfecho é consultado em `transcript_url`. Exige o escopo runs:execute.

Atualizado em 17 de outubro 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.