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-07-15T13:51:48.658Z",
    "expirationDays": 1,
    "expiration": "2025-07-15T13:51:48.658Z",
    "lastUsed": "2025-07-15T13:51:48.658Z",
    "revoked": "2025-07-15T13:51:48.658Z",
    "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-07-15T13:51:48.658Z",
  "expirationDays": 1,
  "expiration": "2025-07-15T13:51:48.658Z",
  "lastUsed": "2025-07-15T13:51:48.658Z",
  "revoked": "2025-07-15T13:51:48.658Z",
  "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?