---
title: "unsubscribe"
method: POST
path: "/event/{topic}/unsubscribe"
tags: ["events"]
---

# unsubscribe

`POST /event/{topic}/unsubscribe`

### Unsubscribe from a topic

Unsubscribe an application endpoint described by the request body from `topic`.
The operation may return before it actually completes, but upon
success it is guaranteed that the endpoint will eventually stop receive
events from the topic.

## Path parameters

- `topic` string, required

## Request body

- object
  - `id` string — The id of the subscription to be removed. If not id is provided, the `topic` will be used as the id.

## Response `200`

A success message.

## Other responses

- `500` — A message describing the error

## Changes

- **2020-05-01** `d9f9d9f05f2d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ibm/apis/kar/changes/event/:topic/unsubscribe/post.md)

---

[API](https://skmtc.dev/ibm/apis/kar.md) · [All operations](https://skmtc.dev/ibm/apis/kar/llms.txt) · [OpenAPI document](https://skmtc.dev/ibm/apis/kar/revisions/d601f556f5f6?raw)