Saltar al contenido principal
POST
Crear un workflow

Autorizaciones

X-API-Key
string
header
requerido

Clave de API para autenticar las solicitudes a la API de Flowker. Se aprovisiona mediante la variable de entorno API_KEY durante el despliegue.

Cuerpo

application/json

Cuerpo de la solicitud que contiene la definición del workflow.

name
string
requerido

Nombre único para el workflow.

Required string length: 1 - 100
Ejemplo:

"Payment Notification Flow"

description
string

Descripción opcional legible por humanos del propósito del workflow.

Maximum string length: 500
Ejemplo:

"Receives a webhook trigger and logs the payment event."

edges
object[]

Conexiones entre nodos que definen el flujo de ejecución. Cada arista vincula un nodo de origen a un nodo de destino, opcionalmente con una condición.

Maximum array length: 200
metadata
object

Pares clave-valor personalizados para etiquetar o categorizar el workflow.

Ejemplo:
nodes
object[]

Los pasos que componen este workflow. Cada nodo es una unidad de trabajo: un disparador, una llamada a ejecutor, una rama condicional o una acción.

Maximum array length: 100

Respuesta

Indica que el recurso fue creado exitosamente y la operación se completó según lo esperado.

createdAt
string<date-time>

Marca de tiempo de cuando se creó el workflow.

Ejemplo:

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

status
string

Estado inicial del workflow (siempre draft al crear).

Ejemplo:

"draft"

version
string

Versión de la definición del workflow.

Ejemplo:

"1.0.0"

workflowId
string<uuid>

Identificador único del workflow creado.

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"