Delete a subscription

DELETE

/v1/subscriptions/{guid}

Removes a subscription for the authenticated user by guid.

The operation is user-specific and does not affect other users subscribed to the same feed.

Parameters

Path Parameters

guid

required

string format: uuid

The globally unique identifier (UUIDv5) of the subscription resource.

Responses

204

Subscription successfully deleted. No content returned.

400

Invalid GUID format.

object

errors

Array<object>

object

status

required

string

Example

404

title

required

string

Example

Subscription not found

detail

string

Example

The requested subscription does not exist for the user.

Example

{
  "errors": [
    {
      "status": "400",
      "title": "Invalid GUID in request",
      "detail": "The requested GUID is not a UUID value"
    }
  ]
}

404

Subscription not found for the authenticated user.

object

errors

Array<object>

object

status

required

string

Example

404

title

required

string

Example

Subscription not found

detail

string

Example

The requested subscription does not exist for the user.

Example

{
  "errors": [
    {
      "status": "404",
      "title": "Subscription not found",
      "detail": "The requested subscription does not exist for the user."
    }
  ]
}