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"
}
}
'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>",
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-API-Key': '<api-key>',
'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 => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-API-Key: <api-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("X-API-Key", "<api-key>")
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("X-API-Key", "<api-key>")
.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["X-API-Key"] = '<api-key>'
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",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}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.
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"
}
}
'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>",
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-API-Key': '<api-key>',
'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 => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-API-Key: <api-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("X-API-Key", "<api-key>")
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("X-API-Key", "<api-key>")
.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["X-API-Key"] = '<api-key>'
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",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}{
"code": "FLK-0001",
"message": "Invalid input provided",
"title": "Bad Request"
}Autorizaciones
Clave de API para autenticar las solicitudes a la API de Flowker. Se aprovisiona mediante la variable de entorno API_KEY durante el despliegue.
Encabezados
Clave de idempotencia única para garantizar reintentos seguros de la misma solicitud.
Parámetros de ruta
Identificador único del workflow.
Cuerpo
Cuerpo de la solicitud que contiene los datos de entrada de la ejecución.
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
Show child attributes
{
"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.
"f7e6d5c4-b3a2-1098-7654-321fedcba098"
Marca de tiempo de cuando se inició la ejecución.
"2026-03-17T14:35:00Z"
Estado inicial de la ejecución (siempre pending).
"running"
ID del workflow que se está ejecutando.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
¿Esta página le ayudó?

