---
title: "Get space permission transition task status"
method: GET
path: "/space-permissions/transition/tasks/{taskId}"
tags: ["Space Permission Transition"]
---

# Get space permission transition task status

`GET /space-permissions/transition/tasks/{taskId}`

Retrieves the status of an async space permission transition task. Use the taskId returned
from the generate-combinations, assign-roles, or remove-access endpoints to poll for
progress and completion.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
User must be a Confluence administrator.

## Path parameters

- `taskId` string, required

## Response `200`

Returned if the task is found and the status is successfully retrieved.

- BulkTransitionTaskStatusResponse
  - `taskId` string, required — The ID of the task.
  - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required — The current status of the task.
  - `errorMessage` string, nullable — Human-readable error message describing why the task failed. Only present when status is FAILED.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `404` — Returned if the task does not exist or the calling user does not have permission to view it.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api-v2/revisions/451377c5a598/schema)