Ejecutar un workflow
curl --request POST \
--url https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"inputData": {
"transactionId": "txn-98765",
"amount": 1500,
"currency": "BRL",
"customerId": "cust-12345",
"message": "Payment received"
}
}
'import requests
url = "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions"
payload = { "inputData": {
"transactionId": "txn-98765",
"amount": 1500,
"currency": "BRL",
"customerId": "cust-12345",
"message": "Payment received"
} }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
inputData: {
transactionId: 'txn-98765',
amount: 1500,
currency: 'BRL',
customerId: 'cust-12345',
message: 'Payment received'
}
})
};
fetch('https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'inputData' => [
'transactionId' => 'txn-98765',
'amount' => 1500,
'currency' => 'BRL',
'customerId' => 'cust-12345',
'message' => 'Payment received'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions"
payload := strings.NewReader("{\n \"inputData\": {\n \"transactionId\": \"txn-98765\",\n \"amount\": 1500,\n \"currency\": \"BRL\",\n \"customerId\": \"cust-12345\",\n \"message\": \"Payment received\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"inputData\": {\n \"transactionId\": \"txn-98765\",\n \"amount\": 1500,\n \"currency\": \"BRL\",\n \"customerId\": \"cust-12345\",\n \"message\": \"Payment received\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inputData\": {\n \"transactionId\": \"txn-98765\",\n \"amount\": 1500,\n \"currency\": \"BRL\",\n \"customerId\": \"cust-12345\",\n \"message\": \"Payment received\"\n }\n}"
response = http.request(request)
puts response.read_body{
"executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
"startedAt": "2026-03-17T14:35:00Z",
"status": "running",
"workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}{
"executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
"startedAt": "2026-03-17T14:35:00Z",
"status": "running",
"workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}Ejecutar un workflow
Utiliza este endpoint para iniciar una nueva ejecución de workflow. La solicitud retorna inmediatamente con estado pending. Utiliza el header Idempotency-Key para garantizar reintentos seguros.
POST
/
v1
/
workflows
/
{workflowId}
/
executions
Ejecutar un workflow
curl --request POST \
--url https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"inputData": {
"transactionId": "txn-98765",
"amount": 1500,
"currency": "BRL",
"customerId": "cust-12345",
"message": "Payment received"
}
}
'import requests
url = "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions"
payload = { "inputData": {
"transactionId": "txn-98765",
"amount": 1500,
"currency": "BRL",
"customerId": "cust-12345",
"message": "Payment received"
} }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
inputData: {
transactionId: 'txn-98765',
amount: 1500,
currency: 'BRL',
customerId: 'cust-12345',
message: 'Payment received'
}
})
};
fetch('https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'inputData' => [
'transactionId' => 'txn-98765',
'amount' => 1500,
'currency' => 'BRL',
'customerId' => 'cust-12345',
'message' => 'Payment received'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions"
payload := strings.NewReader("{\n \"inputData\": {\n \"transactionId\": \"txn-98765\",\n \"amount\": 1500,\n \"currency\": \"BRL\",\n \"customerId\": \"cust-12345\",\n \"message\": \"Payment received\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"inputData\": {\n \"transactionId\": \"txn-98765\",\n \"amount\": 1500,\n \"currency\": \"BRL\",\n \"customerId\": \"cust-12345\",\n \"message\": \"Payment received\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inputData\": {\n \"transactionId\": \"txn-98765\",\n \"amount\": 1500,\n \"currency\": \"BRL\",\n \"customerId\": \"cust-12345\",\n \"message\": \"Payment received\"\n }\n}"
response = http.request(request)
puts response.read_body{
"executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
"startedAt": "2026-03-17T14:35:00Z",
"status": "running",
"workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}{
"executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
"startedAt": "2026-03-17T14:35:00Z",
"status": "running",
"workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}{
"code": "FLK-0001",
"detail": "name is a required field",
"errors": [
{
"location": "body.nodes",
"message": "expected array length >= 1",
"value": "<unknown>"
}
],
"instance": "/v1/workflows",
"status": 400,
"title": "Bad Request",
"type": "https://errors.lerian.studio/v1/FLK-0001"
}Autorizaciones
Token bearer JWT emitido por el provider de identidad. Envíalo en la cabecera Authorization como Bearer <token>.
Encabezados
Clave de idempotencia única para garantizar reintentos seguros de la misma solicitud.
Parámetros de ruta
Identificador único del workflow.
Cuerpo
application/json
Cuerpo de la solicitud que contiene los datos de entrada de la ejecución.
Datos de entrada pasados al workflow. Disponibles para todos los nodes durante la ejecución. El tamaño máximo del payload es 1 MB.
Show child attributes
Show child attributes
Ejemplo:
{
"transactionId": "txn-98765",
"amount": 1500,
"currency": "BRL",
"customerId": "cust-12345",
"message": "Payment received"
}
Respuesta
Indica que una solicitud idéntica ya fue procesada. Retorna la ejecución original.
Identificador único de la ejecución.
Ejemplo:
"f7e6d5c4-b3a2-1098-7654-321fedcba098"
Marca de tiempo de cuando se inició la ejecución.
Ejemplo:
"2026-03-17T14:35:00Z"
Estado inicial de la ejecución (siempre pending).
Ejemplo:
"running"
ID del workflow que se está ejecutando.
Ejemplo:
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
¿Esta página le ayudó?
⌘I