API

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

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

Scenarios

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

Store a scenario

post
Authorizations
Body
objectOptional
Responses
201

Created

post
POST /scenarios HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

No content

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

delete
DELETE /scenarios/{id} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*

No content

Processes

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

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

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

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

API keys

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-08-22T08:36:26.384Z",
    "expirationDays": 1,
    "expiration": "2025-08-22T08:36:26.384Z",
    "lastUsed": "2025-08-22T08:36:26.384Z",
    "revoked": "2025-08-22T08:36:26.384Z",
    "privileges": "scenario:read",
    "processes": [
      {
        "scenario": "123e4567-e89b-12d3-a456-426614174000",
        "actors": [
          "text"
        ],
        "actions": [
          "text"
        ]
      }
    ]
  }
]

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-08-22T08:36:26.384Z",
  "expirationDays": 1,
  "expiration": "2025-08-22T08:36:26.384Z",
  "lastUsed": "2025-08-22T08:36:26.384Z",
  "revoked": "2025-08-22T08:36:26.384Z",
  "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

Last updated

Was this helpful?