VolundOS
Referência da APIPipelines

Disparar um pipeline

Inicia uma execução e responde na hora com o identificador dela. O disparo é sempre assíncrono: um pipeline encadeia vários agentes e pode levar horas, então não existe modo síncrono. Acompanhe pelo `progress_url` ou informe um `callback_url` para receber o resultado quando terminar. O que você manda em `context` fica disponível para as etapas como `{{trigger.input.<campo>}}`. O filtro de entrada do pipeline não se aplica a este disparo - ele vale só para gatilhos de agenda e de aplicativo. Exige o escopo runs:execute.

Atualizado em 21 de setembro de 2026
POST
/v1/pipelines/{pipelineId}/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

pipelineId*string

Identificador do pipeline. Aparece na aba API da tela do pipeline.

Header Parameters

Idempotency-Key?string

Apelido de dedupe_key. Repetir a mesma chave devolve a execução já criada em vez de criar outra.

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

application/json

application/json

curl -X POST "https://example.com/v1/pipelines/string/run" \  -H "Content-Type: application/json" \  -d '{}'
{  "run_id": "string",  "pipeline_id": "string",  "status": "running",  "deduped": true,  "error_message": "string",  "progress_url": "http://example.com"}