VolundOS
Referência da APIPipelines

Acompanhar uma execução

O estado da execução e cada etapa: o final escolhido, o que ela devolveu e o link da transcrição do agente daquela etapa. É o mecanismo de acompanhamento da superfície e não tem limite de chamadas; um intervalo de 2 a 3 segundos é suficiente. A transcrição de uma etapa só é legível pela chave que iniciou aquela execução - em execuções disparadas por outra pessoa, ou pela interface, `GET /v1/runs/{runId}` responde 404 para ela, e o progresso continua completo aqui. Exige o escopo runs:read.

Atualizado em 21 de setembro de 2026
GET
/v1/pipelines/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 da execução, devolvido no disparo.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/pipelines/runs/string"
{  "run_id": "string",  "pipeline_id": "string",  "status": "running",  "trigger_source": "manual",  "error": "string",  "created_at": "2019-08-24T14:15:22Z",  "finished_at": "2019-08-24T14:15:22Z",  "steps_started": 0,  "max_steps_total": 0,  "progress_url": "http://example.com",  "steps": [    {      "step": "string",      "name": "string",      "attempt": 0,      "status": "scheduled",      "outcome": "string",      "output": {},      "error": "string",      "started_at": "2019-08-24T14:15:22Z",      "finished_at": "2019-08-24T14:15:22Z",      "agent_run_id": "string",      "transcript_url": "http://example.com"    }  ]}