Skip to content

Removes a subscription.

DELETE
/v1/m/eventing/subscriptions/{id}
curl --request DELETE \
--url https://example.com/v1/m/eventing/subscriptions/example \
--header 'Authorization: Bearer <token>'

Removes a subscription. Its queued deliveries are dead-lettered lazily by the dispatcher (subscription_deleted) — the rows stay as evidence until retention prunes them.

id
required
string

Path parameter id.

X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

OK

Media type application/json
object
Example generated
{}

Bad request

Media type application/json
object
Example generated
{}

Unauthenticated

Media type application/json
object
Example generated
{}

Forbidden

Media type application/json
object
Example generated
{}

Not found

Media type application/json
object
Example generated
{}

Conflict / setup required

Media type application/json
object
Example generated
{}

Rate limited

Media type application/json
object
Example generated
{}