Check process status

Returns the status of one or more processes started by the Mindtickle group APIs, by process ID.

View as Markdown

Prerequisites

Authentication and setup: A valid access token.
Groups: A group API call that returned a process ID.

Endpoint

POST /services/data/v2.0/status

Base URL: the standard REST host for your region. See Base URLs.

Headers: Authorization: Bearer ACCESS_TOKEN, Content-Type: application/json.

Request

Parameter	Type	Required	Description
`processIds`	Array[string]	Required	ID of the process. Send each ID as a separate string in the JSON array.

Request example

{
  "processIds": ["1234567890123456101", "1234567890123456102", "1234567890123456103"]
}

Response

Field	Type	Description
`requestId`	string or null	Request identifier. The response examples return `null`.
`responseCode`	integer	Special response codes from the server.
`responseType`	string	Type of response from the server.
`taskCompleted`	boolean	Completion flag for the status-check request. Read each entry in `status` to determine whether the original process has finished.
`status`	StatusMap	Process ID and the corresponding status: `QUEUED`, `RUNNING`, `SUCCESS`, or `FAILED`.

Response example

{
  "requestId": null,
  "responseCode": 0,
  "responseType": "STATUS_CHECK_RESPONSE",
  "taskCompleted": true,
  "status": {
    "1234567890123456101": "SUCCESS",
    "1234567890123456102": "SUCCESS",
    "1234567890123456103": "SUCCESS"
  }
}