---
title: "Retrieve the mount task status"
method: GET
path: "/v1/cloud-storage/mount-tasks"
tags: ["Cloud Storage"]
---

# Retrieve the mount task status

`GET /v1/cloud-storage/mount-tasks`

This operation retrieves the status of a task responsible for mounting or unmounting topics. It provides details on the task’s type (mount or unmount), its current state, and the topics involved.

## Response `200`

OK

- ListMountTasksResponse
  - `tasks` 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)