Returns the status of a given task, including a list of any failures on completion. Permissions required: Administer Jira global permission, or Customer Service Management or Jira Service Management user.

OAuth 2.0 scopes required:

read:task:jira-service-management

Request

Path parameters

taskId

string

Required

Header parameters

X-ExperimentalApi

ExperimentalHeader

Required

Responses

Returns the task.

application/json

TaskStatusResponse

GET/api/v1/tasks/{taskId}

curl

Node.js

Java

Python

PHP

curl --request GET \
  --url 'https://api.atlassian.com/jsm/csm/cloudid/{cloudId}/api/v1/tasks/{taskId}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json' \
  --header 'X-ExperimentalApi: opt-in'

200Response

{
  "id": "3858a61a-d337-42e6-993e-e13e1c366d4f",
  "type": "BULK_CUSTOMER_PROFILE_CREATE_UPDATE",
  "status": "IN_PROGRESS",
  "failures": [
    {
      "entity": "CUSTOMER",
      "entityId": "qm:9edf598a-85d4-4db9-bf2e-7245922b4ea8:0000e9d8-a22e-4220-ac63-412ff9eec053",
      "operation": "CREATE",
      "operatedOn": "CUSTOMER_ACCOUNT",
      "operatedOnIds": [
        "Region"
      ],
      "error": "Invalid detail field"
    }
  ],
  "createdAt": "2025-01-15T11:12:13Z",
  "updatedAt": "2025-01-15T11:12:13Z"
}