Pular para o conteúdo principal
POST
/
v1
/
workflows
/
{workflowId}
/
executions
Executar um workflow
curl --request POST \
  --url https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "inputData": {
    "transactionId": "txn-98765",
    "amount": 1500,
    "currency": "BRL",
    "customerId": "cust-12345",
    "message": "Payment received"
  }
}
'
{
  "executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
  "startedAt": "2026-03-17T14:35:00Z",
  "status": "running",
  "workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Autorizações

​
X-API-Key
string
header
obrigatório

API key for authenticating requests to the Flowker API. Provisioned via the API_KEY environment variable during deployment.

Cabeçalhos

​
Idempotency-Key
string
obrigatório

Chave de idempotência única para garantir retentativas seguras da mesma solicitação.

Parâmetros de caminho

​
workflowId
string<uuid>
obrigatório

Identificador único do workflow.

Corpo

application/json

Corpo da solicitação contendo os dados de entrada da execução.

​
inputData
object
obrigatório

Dados de entrada passados ao workflow. Disponíveis para todos os nós durante a execução. O tamanho máximo do payload é 1 MB.

Exemplo:
{
  "transactionId": "txn-98765",
  "amount": 1500,
  "currency": "BRL",
  "customerId": "cust-12345",
  "message": "Payment received"
}

Resposta

Indica que uma solicitação idêntica já foi processada. Retorna a execução original.

​
executionId
string<uuid>

Identificador único da execução.

Exemplo:

"f7e6d5c4-b3a2-1098-7654-321fedcba098"

​
startedAt
string<date-time>

Marca temporal de quando a execução foi iniciada.

Exemplo:

"2026-03-17T14:35:00Z"

​
status
string

Status inicial da execução (sempre pending).

Exemplo:

"running"

​
workflowId
string<uuid>

ID do workflow sendo executado.

Exemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"