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"
}Executar um workflow
Utilize este endpoint para iniciar uma nova execução de workflow. A solicitação retorna imediatamente com status pending. Utilize o header Idempotency-Key para garantir retentativas seguras.
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"
}Autorizações
Chave de API para autenticar as requisições à API do Flowker. Provisionada por meio da variável de ambiente API_KEY durante o deployment.
Cabeçalhos
Chave de idempotência única para garantir retentativas seguras da mesma solicitação.
Parâmetros de caminho
Identificador único do workflow.
Corpo
Corpo da solicitação contendo os dados de entrada da execução.
Dados de entrada passados ao workflow. Disponíveis para todos os nós durante a execução. O tamanho máximo do payload é 1 MB.
Show child attributes
Show child attributes
{
"transactionId": "txn-98765",
"amount": 1500,
"currency": "BRL",
"customerId": "cust-12345",
"message": "Payment received"
}
Resposta
Indica que uma solicitação idêntica já foi processada. Retorna a execução original.
Identificador único da execução.
"f7e6d5c4-b3a2-1098-7654-321fedcba098"
Marca temporal de quando a execução foi iniciada.
"2026-03-17T14:35:00Z"
Status inicial da execução (sempre pending).
"running"
ID do workflow sendo executado.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Esta página foi útil?

