Listar workflows

curl --request GET \
  --url https://flowker.sandbox.lerian.net/v1/workflows \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flowker.sandbox.lerian.net/v1/workflows', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/workflows"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flowker.sandbox.lerian.net/v1/workflows")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Payment Notification Flow",
      "description": "Receives a webhook trigger and logs the payment event.",
      "status": "active",
      "nodes": [
        {
          "id": "trigger-1",
          "type": "trigger",
          "name": "Webhook Trigger",
          "position": {
            "x": 0,
            "y": 0
          },
          "data": {
            "triggerType": "webhook",
            "path": "payments/received",
            "method": "POST",
            "input_contract": "open",
            "format": "json"
          }
        },
        {
          "id": "log-event",
          "type": "action",
          "name": "Log Payment Event",
          "position": {
            "x": 200,
            "y": 0
          },
          "data": {
            "action": "log"
          }
        }
      ],
      "edges": [
        {
          "id": "e1",
          "source": "trigger-1",
          "target": "log-event"
        }
      ],
      "metadata": {
        "team": "payments"
      },
      "createdAt": "2026-03-17T14:30:00Z",
      "updatedAt": "2026-03-17T14:31:00Z"
    }
  ],
  "nextCursor": "",
  "hasMore": false
}

{
  "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"
}

GET

workflows

Listar workflows

curl --request GET \
  --url https://flowker.sandbox.lerian.net/v1/workflows \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flowker.sandbox.lerian.net/v1/workflows', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/workflows"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flowker.sandbox.lerian.net/v1/workflows")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Payment Notification Flow",
      "description": "Receives a webhook trigger and logs the payment event.",
      "status": "active",
      "nodes": [
        {
          "id": "trigger-1",
          "type": "trigger",
          "name": "Webhook Trigger",
          "position": {
            "x": 0,
            "y": 0
          },
          "data": {
            "triggerType": "webhook",
            "path": "payments/received",
            "method": "POST",
            "input_contract": "open",
            "format": "json"
          }
        },
        {
          "id": "log-event",
          "type": "action",
          "name": "Log Payment Event",
          "position": {
            "x": 200,
            "y": 0
          },
          "data": {
            "action": "log"
          }
        }
      ],
      "edges": [
        {
          "id": "e1",
          "source": "trigger-1",
          "target": "log-event"
        }
      ],
      "metadata": {
        "team": "payments"
      },
      "createdAt": "2026-03-17T14:30:00Z",
      "updatedAt": "2026-03-17T14:31:00Z"
    }
  ],
  "nextCursor": "",
  "hasMore": false
}

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

Authorization

string

header

requerido

Token bearer JWT emitido por el provider de identidad. Envíalo en la cabecera Authorization como Bearer <token>.

Parámetros de consulta

status

enum<string>

Filtrar resultados por estado.

Opciones disponibles:

draft,

active,

inactive

limit

integer

predeterminado:10

Número máximo de elementos a retornar por página. Por defecto es 10. Debe estar entre 1 y 100.

Rango requerido: 1 <= x <= 100

cursor

string

Cursor para paginación. Utiliza el valor del campo nextCursor de una respuesta anterior para recuperar la siguiente página.

sortBy

enum<string>

predeterminado:createdAt

Campo por el cual ordenar los resultados.

Opciones disponibles:

createdAt,

updatedAt,

name

sortOrder

enum<string>

predeterminado:DESC

Dirección de ordenamiento. Utiliza ASC para ascendente o DESC para descendente.

Opciones disponibles:

ASC,

DESC

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados.

hasMore

boolean

Indica si hay más páginas disponibles.

Ejemplo:

true

items

object[]

Lista de definiciones de workflows en la página actual.

Show child attributes

nextCursor

string

Cursor a pasar en la siguiente solicitud para recuperar la página siguiente.

Ejemplo:

"eyJpZCI6ImExYjJjM2Q0In0="

⌘I

Primeros pasos

API de Catálogo

API de Workflows

API de Programación

API de Ejecuciones

API de Dashboards

API de Configuraciones de Executor

API de Configuraciones de Provider

API de Registro de Esquemas

API de Esquemas OpenAPI

API de Esquemas XSD

API de Webhooks

Manejo de errores

Listar workflows

Autorizaciones

Parámetros de consulta

Respuesta