VolundOS
Referência da APIExecução

Consultar um run

Devolve o estado do run e o passo a passo completo. Serve tanto para confirmar o resultado de um run assíncrono quanto para inspecionar as etapas intermediárias. Exige o escopo runs:read.

Atualizado em 13 de agosto de 2026
GET
/v1/runs/{runId}

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.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/runs/string"
{  "run_id": "string",  "agent_id": "string",  "status": "completed",  "output": "string",  "steps": [    {      "role": "string",      "content": "string",      "thinking": "string",      "created_at": "2019-08-24T14:15:22Z"    }  ]}