---
title: "Mount topics from object storage"
method: POST
path: "/v1/cloud-storage/topics/mount"
tags: ["Cloud Storage"]
---

# Mount topics from object storage

`POST /v1/cloud-storage/topics/mount`

Attach mountable topics from object storage to a cluster, making them available for consumption and production again. Mounting a topic reloads its data and state to the local brokers, allowing active use of the topic.

## Request body

- TopicMount[]
  - `alias` string — Alias may be provided to mount the topic under a different name. Leave blank to re-use the source topic name. The alias does not persist if you unmount the topic again.
  - `source_topic_reference` string, required — The topic name or full reference of the topic to mount. The full reference must be used in case the same topic exists more than once. This may be the case if the same topic has been unmounted multiple times. List all mountable topics to find the full reference (contains topic name, cluster uuid and revision).

## Response `200`

OK

- MountTopicsResponse
  - `mount_task_id` integer

## 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)
