List live and replay execution diagnostics.

GET

/v1/tenants/{tenantNumber}/flow-executions

const url = 'https://api.dev.iot-sens.schlossers.at/v1/tenants/1/flow-executions?status=queued&limit=25';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.dev.iot-sens.schlossers.at/v1/tenants/1/flow-executions?status=queued&limit=25' \
  --header 'Authorization: Bearer <token>'

Returns reverse-chronological pages without an exact total. The first request fixes to as the investigation anchor. Continuations reuse that anchor, Tenant scope, every filter, and the requested page size. The API defaults to 25 and accepts 1 through 100; the Web Console requests 25 per explicit load.

Authorizations

AccessToken

Parameters

Path Parameters

tenantNumber

required

integer format: int32

>= 1 <= 2147483647

Query Parameters

from

string format: date-time

Optional inclusive lower timestamp for the investigation.

string format: date-time

Fixed exclusive upper anchor; defaults to current server time and continuations reuse it.

flowId

string format: uuid

organizationUnitId

string format: uuid

Historical Organization assignment at the Execution timestamp.

status

string

Allowed values: queued running succeeded failed dead_lettered skipped_no_flow

cursor

string

<= 512 characters

Opaque continuation token; reuse the original filters and scope.

limit

integer

default: 25 >= 1 <= 100

Number of timeline records to return; defaults to 25, accepts 1 through 100, and is bound into continuation cursors.

Responses

200

Anchored progressive Flow Execution page.

application/json

object

items

required

Array<object>

object

flowExecutionId

required

string format: uuid

tenantId

required

string format: uuid

flowId

required

string | null format: uuid

flowVersionId

required

string | null format: uuid

mode

required

string

Allowed values: live preview replay

status

required

string

Allowed values: queued running succeeded failed dead_lettered skipped_no_flow

createdAt

required

string format: date-time

finishedAt

required

One of:

string
null

string format: date-time

key

additional properties

any

nextCursor

string

Example

{
  "items": [
    {
      "mode": "live",
      "status": "queued"
    }
  ]
}

default

A safe platform error response.

application/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED AUTHENTICATION_FAILED AUTHORIZATION_FAILED RESOURCE_NOT_FOUND CONFLICT DEPENDENCY_FAILURE FLOW_FAILURE RATE_LIMITED INTERNAL_ERROR

category

required

string

Allowed values: validation authentication authorization not_found conflict dependency_failure flow_failure rate_limit internal

message

required

Safe client-facing diagnostic message.

string

correlationId

required

Correlation ID for operational investigation.

string

>= 1 characters

details

Safe bounded diagnostic details.

object

key

additional properties

One of:

string

Example

{
  "error": {
    "code": "VALIDATION_FAILED",
    "category": "validation"
  }
}

Headers

Cache-Control

string

Allowed value: no-store