LetsFlow
  • Introduction
  • Tutorial
    • The basics
    • A handshake
    • A conversation
    • A proper introduction
    • Group meeting
    • Quote
  • Cookbook
  • ENGINE
    • Installation
    • Authentication
    • API
    • Services
      • Configuration
      • Messaging
        • ZeroMQ
        • AMQP 0-9-1
        • Webhook
      • Engine service
  • Integration
    • Frontend
      • React
      • Angular
      • Vue
      • Svelte
    • Backend
  • Reference
    • Scenario
      • Actor
      • Action
        • Update instruction
      • State
        • Transition
          • Log
        • Notify
      • Data function
    • Schema
    • Process
      • Current state
      • Previous log
      • Prediction
      • Events
        • Instantiate event
        • Action event
        • Timeout event
  • Libraries
    • Core library
    • JMESPath
    • Test suite
      • Given
      • When
      • Then
        • Assert state
        • Assert actor
        • Assert variable
        • Assert service
        • Assert event
      • Customize
  • Advanced topics
    • Deep integration
    • Decentralized workflows
    • Custom JMESPath functions
    • Custom YAML tags
Powered by GitBook
On this page

Was this helpful?

  1. ENGINE

API

PreviousAuthenticationNextServices

Last updated 4 months ago

Was this helpful?

Demo accounts are only available when the engine is running in development mode.

Scenarios

Processes

API keys

Get system information

get
Responses
200Success
get
GET /info HTTP/1.1
Host: 
Accept: */*
200Success

No content

Get demo accounts

get
Responses
200Success
get
GET /demo-accounts HTTP/1.1
Host: 
Accept: */*
200Success

No content

List scenarios

get
Authorizations
Responses
200
Success
application/json
get
GET /scenarios HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
200

Success

[
  {
    "id": "text",
    "name": "text",
    "title": "text",
    "description": "text"
  }
]

Get a scenario by ID

get
Authorizations
Path parameters
idstring · uuidRequired

Scenario ID

Header parameters
Acceptstring · enumOptionalPossible values:
Responses
200
Success
get
GET /scenarios/{id} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
200

Success

No content

Disable a scenario

delete
Authorizations
Path parameters
idstring · uuidRequired

Scenario ID

Responses
204
No Content
403
Read-only mode
delete
DELETE /scenarios/{id} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*

No content

List processes

get
Authorizations
Path parameters
pagenumberRequired

List page (max 100 processes per page)

allbooleanRequired

Also return processes where user is not an actor in (admin only)

Responses
200
Success
get
GET /processes HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
200

Success

No content

Get a process by ID

get
Authorizations
Path parameters
idstring · uuidRequired

Process ID

Responses
200
Success
get
GET /processes/{id} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
200

Success

No content

List API keys

get
Authorizations
Responses
200
Success
application/json
get
GET /apikey HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
200

Success

[
  {
    "id": "text",
    "token": "text",
    "name": "text",
    "description": {},
    "issued": "2025-05-17T06:20:42.079Z",
    "expirationDays": 1,
    "expiration": "2025-05-17T06:20:42.079Z",
    "lastUsed": "2025-05-17T06:20:42.079Z",
    "revoked": "2025-05-17T06:20:42.079Z",
    "privileges": "scenario:read",
    "processes": [
      {
        "scenario": "123e4567-e89b-12d3-a456-426614174000",
        "actors": [
          "text"
        ],
        "actions": [
          "text"
        ]
      }
    ]
  }
]

Revoke an API key

delete
Authorizations
Path parameters
idstringRequired
Responses
204
No Content
delete
DELETE /apikey/{id} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
204

No Content

No content

  • GETGet system information
  • GETGet demo accounts
  • Scenarios
  • GETList scenarios
  • POSTStore a scenario
  • GETGet a scenario by ID
  • DELETEDisable a scenario
  • Processes
  • GETList processes
  • POSTStart a process
  • GETGet a process by ID
  • POSTStep through a process
  • API keys
  • GETList API keys
  • POSTIssue a new API key
  • DELETERevoke an API key

Store a scenario

post
Authorizations
Body
objectOptional
Responses
201
Created
400
Invalid scenario
403
Read-only mode
post
POST /scenarios HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

No content

Start a process

post
Authorizations
Header parameters
As-ActorstringRequired
Body
scenariostringRequired
actionobjectOptional
Responses
201
Created
post
POST /processes HTTP/1.1
Host: 
Authorization: Bearer jwt
As-Actor: text
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "scenario": "text",
  "actors": {
    "ANY_ADDITIONAL_PROPERTY": {
      "id": "text",
      "title": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "action": {}
}
201

Created

No content

Step through a process

post
Authorizations
Path parameters
idstring · uuidRequired

Process ID

actionstringRequired

Process action

Header parameters
As-ActorstringOptional

Specify actor when multiple actors could have performed the action and actor cannot be determined based on the user

Body
stringOptional
Responses
204
No Content
post
POST /processes/{id}/{action} HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"
204

No Content

No content

Issue a new API key

post
Authorizations
Body
namestringRequired
descriptionstringRequired
Responses
201
Created
application/json
post
POST /apikey HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 170

{
  "name": "text",
  "description": "text",
  "privileges": [
    "scenario:read"
  ],
  "processes": [
    {
      "scenario": "123e4567-e89b-12d3-a456-426614174000",
      "actors": [
        "text"
      ],
      "actions": [
        "text"
      ]
    }
  ]
}
201

Created

{
  "id": "text",
  "token": "text",
  "name": "text",
  "description": {},
  "issued": "2025-05-17T06:20:42.079Z",
  "expirationDays": 1,
  "expiration": "2025-05-17T06:20:42.079Z",
  "lastUsed": "2025-05-17T06:20:42.079Z",
  "revoked": "2025-05-17T06:20:42.079Z",
  "privileges": "scenario:read",
  "processes": [
    {
      "scenario": "123e4567-e89b-12d3-a456-426614174000",
      "actors": [
        "text"
      ],
      "actions": [
        "text"
      ]
    }
  ]
}