Find task

Deprecated

Deprecated — use GET /action-runs/{actionRunId} instead. Find a one-off registry task by id.

GET

/v1/tasks/{taskId}

GET

/tasks/{taskId}

curl -X GET "https://api.corma.io/v1/tasks/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

Authorization

x-corma-api-key
string
header
required
Colon-separated API key ID and secret: API_KEY_ID:API_KEY_SECRET

Parameters

taskId
integer
path
required

Response

application/json200

id
integer
required
Identifies the run. Pass it as actionRunId to fetch this run again.
status
enum<string>
required
One of:
ongoing
completed
errored
source
enum<string>
required
What triggered the run. public_api is a run this API triggered; the log also covers runs triggered from the web app.
One of:
public_api
web_app
copilot
actionIdentifier
string
required
The action that was triggered.
payload
map of any
required
The payload the run was triggered with.
errorMessage
string | null
required
triggeredBy
UserEmbed | null
required
createdAt
string<date-time>
required
The timestamp of when this resource was created. ISO 8601 format.
updatedAt
string<date-time>
required
The timestamp of the last update to this resource. ISO 8601 format.

{
  "id": -9007199254740991,
  "status": "ongoing",
  "source": "public_api",
  "actionIdentifier": "string",
  "payload": {
    "key": null
  },
  "errorMessage": "string",
  "triggeredBy": {
    "id": "string",
    "type": "employee",
    "email": "string",
    "personalEmail": "string",
    "name": "string",
    "idpStatus": "active",
    "hrStatus": "active",
    "jobKey": "string",
    "countryCode": "string",
    "departmentKey": "string",
    "startDate": "2026-01-15T09:30:00Z",
    "terminationDate": "2026-01-15T09:30:00Z"
  },
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}

GET

/tasks/{taskId}

curl -X GET "https://api.corma.io/v1/tasks/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

{
  "id": -9007199254740991,
  "status": "ongoing",
  "source": "public_api",
  "actionIdentifier": "string",
  "payload": {
    "key": null
  },
  "errorMessage": "string",
  "triggeredBy": {
    "id": "string",
    "type": "employee",
    "email": "string",
    "personalEmail": "string",
    "name": "string",
    "idpStatus": "active",
    "hrStatus": "active",
    "jobKey": "string",
    "countryCode": "string",
    "departmentKey": "string",
    "startDate": "2026-01-15T09:30:00Z",
    "terminationDate": "2026-01-15T09:30:00Z"
  },
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}

- GETFind task
- POSTCreate task

Find task - Corma Help Center | Productlane

API referenceTasks

Find task

Deprecated

Deprecated — use GET /action-runs/{actionRunId} instead. Find a one-off registry task by id.

GET

/v1/tasks/{taskId}

GET

/tasks/{taskId}

curl -X GET "https://api.corma.io/v1/tasks/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

Authorization

x-corma-api-key
string
header
required
Colon-separated API key ID and secret: API_KEY_ID:API_KEY_SECRET

Parameters

taskId
integer
path
required

Response

application/json200

id
integer
required
Identifies the run. Pass it as actionRunId to fetch this run again.
status
enum<string>
required
One of:
ongoing
completed
errored
source
enum<string>
required
What triggered the run. public_api is a run this API triggered; the log also covers runs triggered from the web app.
One of:
public_api
web_app
copilot
actionIdentifier
string
required
The action that was triggered.
payload
map of any
required
The payload the run was triggered with.
errorMessage
string | null
required
triggeredBy
UserEmbed | null
required
createdAt
string<date-time>
required
The timestamp of when this resource was created. ISO 8601 format.
updatedAt
string<date-time>
required
The timestamp of the last update to this resource. ISO 8601 format.

{
  "id": -9007199254740991,
  "status": "ongoing",
  "source": "public_api",
  "actionIdentifier": "string",
  "payload": {
    "key": null
  },
  "errorMessage": "string",
  "triggeredBy": {
    "id": "string",
    "type": "employee",
    "email": "string",
    "personalEmail": "string",
    "name": "string",
    "idpStatus": "active",
    "hrStatus": "active",
    "jobKey": "string",
    "countryCode": "string",
    "departmentKey": "string",
    "startDate": "2026-01-15T09:30:00Z",
    "terminationDate": "2026-01-15T09:30:00Z"
  },
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}

GET

/tasks/{taskId}

curl -X GET "https://api.corma.io/v1/tasks/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

{
  "id": -9007199254740991,
  "status": "ongoing",
  "source": "public_api",
  "actionIdentifier": "string",
  "payload": {
    "key": null
  },
  "errorMessage": "string",
  "triggeredBy": {
    "id": "string",
    "type": "employee",
    "email": "string",
    "personalEmail": "string",
    "name": "string",
    "idpStatus": "active",
    "hrStatus": "active",
    "jobKey": "string",
    "countryCode": "string",
    "departmentKey": "string",
    "startDate": "2026-01-15T09:30:00Z",
    "terminationDate": "2026-01-15T09:30:00Z"
  },
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}