Saltar al contenido principal
POST
/
v1
/
webhooks
/
{path}
Disparar un webhook
curl --request POST \
  --url https://flowker.sandbox.lerian.net/v1/webhooks/{path} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'
{
  "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

Clave de idempotencia opcional para evitar ejecuciones duplicadas a partir de la misma entrega de webhook.

​
X-Webhook-Token
string

Token de verificación por webhook. Validado por el handler cuando está configurado en la ruta del webhook.

Parámetros de ruta

​
path
string
requerido

Ruta de webhook registrada por un workflow. Soporta rutas anidadas con múltiples segmentos en tiempo de ejecución.

Cuerpo

application/json

Payload del webhook. Tamaño máximo de 1 MB.

Payload del webhook proveniente del sistema externo. Flowker inyecta metadatos del webhook (clave _webhook con método, ruta, headers, parámetros de query e IP remota) antes de pasarlo al workflow.

Respuesta

Ejecución del workflow completada de forma síncrona (estado terminal).

​
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"