---
title: "POST /v1/{+subscription}:detach"
method: POST
path: "/v1/{+subscription}:detach"
tags: ["projects"]
---

# POST /v1/{+subscription}:detach

`POST /v1/{+subscription}:detach`

Detaches a subscription from this topic. All messages retained in the subscription are dropped. Subsequent `Pull` and `StreamingPull` requests will return FAILED_PRECONDITION. If the subscription is a push subscription, pushes to the endpoint will stop.

## Path parameters

- `subscription` string, required

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/pubsub.md) · [All operations](https://skmtc.net/google/apis/pubsub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/pubsub/versions/bf72396b5785/schema)