Ejecutar un workflow

Utilice este endpoint para iniciar una nueva ejecución de workflow. La solicitud retorna inmediatamente con estado pending. Utilice el header Idempotency-Key para garantizar reintentos seguros.

POST /v1/workflows/{workflowId}/executions

Ejecutar un workflow

cURL

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"
  }
}
'

200

{
  "executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
  "startedAt": "2026-03-17T14:35:00Z",
  "status": "running",
  "workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Autorizaciones

X-API-Key · string · header · requerido

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

Encabezados

Idempotency-Key · string · requerido

Clave de idempotencia única para garantizar reintentos seguros de la misma solicitud.

Parámetros de ruta

workflowId · string<uuid> · requerido

Identificador único del workflow.

Cuerpo

application/json

Cuerpo de la solicitud que contiene los datos de entrada de la ejecución.

inputData · object · requerido

Datos de entrada pasados al workflow. Disponibles para todos los nodos durante la ejecución. El tamaño máximo del payload es 1 MB.

Show child attributes

Ejemplo:

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

Respuesta

200

application/json

Indica que una solicitud idéntica ya fue procesada. Retorna la ejecución original.

executionId · string<uuid>

Identificador único de la ejecución.

Ejemplo:

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

startedAt · string<date-time>

Marca de tiempo de cuando se inició la ejecución.

Ejemplo:

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

status · string

Estado inicial de la ejecución (siempre pending).

Ejemplo:

"running"

workflowId · string<uuid>

ID del workflow que se está ejecutando.

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"