---
title: "Get the status of a mount or unmount by ID"
method: GET
path: "/v1/cloud-storage/mount-tasks/{id}"
tags: ["Cloud Storage"]
---

# Get the status of a mount or unmount by ID

`GET /v1/cloud-storage/mount-tasks/{id}`

Retrieves the status of a mount or unmount by ID. The response provides details on the operation type (mount or unmount), its current state, and the topics involved. Use the ID returned when you start the mount or unmount, or use the ListMountTasks endpoint to retrieve a list of IDs.

## Path parameters

- `id` integer, required

## Response `200`

OK

- GetMountTaskResponse
  - `task` MountTask
    - `id` integer — Unique identifier for this mount task.
    - `state` 'STATE_PLANNED' | 'STATE_PREPARING' | 'STATE_PREPARED' | 'STATE_EXECUTING' | 'STATE_EXECUTED' | 'STATE_CUT_OVER' | 'STATE_FINISHED' | 'STATE_CANCELING' | 'STATE_CANCELLED' — - STATE_PLANNED: Planned: The mount task has been created and is awaiting further actions. - STATE_PREPARING: Preparing: The mount task is gathering resources and preparing for execution. - STATE_PREPARED: Prepared: All preparations are complete, and the mount task is ready to be executed. - STATE_EXECUTING: Executing: The mount task is actively transferring or transforming data. - STATE_EXECUTED: Executed: The core mount task actions are complete, but the mount task has not yet cut over or finalized. - STATE_CUT_OVER: Cut Over: The mount task has reached a critical point where ownership is transferred or final adjustments are made. - STATE_FINISHED: Finished: The mount task has been successfully completed, and no further actions are required. - STATE_CANCELING: Canceling: The mount task is in the process of being canceled, and rollback or cleanup actions may be in progress. - STATE_CANCELLED: Cancelled: The mount task has been fully canceled, and no further actions will be taken.
    - `topics` MountTaskTopic[] — List of topics that are being mounted or unmounted.
      - `source_topic_reference` string — The topic reference in the object storage bucket. This field is only set for tasks of type MOUNT.
      - `topic_reference` string — The topic reference within the current cluster, which may be either a simple topic name or a full reference in the form: cluster-uuid/topic-name/revision.
    - `type` 'TYPE_MOUNT' | 'TYPE_UNMOUNT' — - TYPE_MOUNT: Mount represents the process of making topics available in a cluster by loading them from object storage. - TYPE_UNMOUNT: Unmount represents the process of offloading topics back to object storage.

## Other responses

- `401` — Unauthenticated.
- `404` — Not Found
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/revisions/7eef0bcc42e7/schema)