Get Task History

Required capabilities: integrationsAcl:READ

List task history with optional filtering and pagination.

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code
Request
query Parameters
externalId
string (Integration External Id)

Return task histories belonging to a specific integration.

taskName
string (TaskName)

Return task histories belonging to a specific task. Requires integration to be specified.

lastPerTask
boolean (LastPerTask)

If true, return the last task history entry for each task.

limit
integer [ 1 .. 100 ]
Default: 100

Limits the number of results to be returned. The maximum results returned by the server is 100 even if you specify a higher limit.

cursor
string

Cursor for paging through results. In general, if a response contains a nextCursor property, it means that there may be more results, and you should pass that value as the cursor parameter in the next request.

Note that the cursor may or may not be encrypted, but either way, it is not intended to be decoded. Its internal structure is not a part of the public API, and may change without notice. You should treat it as an opaque string and not attempt to craft your own cursors.

Example: cursor=4zj0Vy2fo0NtNMb229mI9r1V3YG5NBL752kQz1cKtwo
Responses
200

List of task histories.

400

The response for a bad request.

422

Request validation failed.

get/integrations/history
Request samples
Response samples
application/json
{
  • "items": [
    • {
      }
    ],
  • "nextCursor": "string"
}