Delete a subscription

• Request format
  • Path parameters
  • Headers
• Server behavior
• Success response
• Error responses

Enables clients to remove a subscription for the authenticated user by guid.

DELETE /v1/subscriptions/{guid}

Request format

Clients MUST send a DELETE request to the canonical URI of a subscription resource.

Path parameters

Headers

Clients MUST include the following header:

• Accept: application/vnd.api+json

DELETE /v1/subscriptions/ce510f4d-9046-5590-846e-58619ab8b353 HTTP/1.1
Accept: application/vnd.api+json

Server behavior

• The server MUST remove the subscription for the authenticated user.
• The deletion MUST NOT affect other users subscribed to the same feed.
• The server MUST return a 204 No Content if the subscription was deleted.
• If no subscription exists for the user, the server MUST return 404 Not Found.
• If the guid is not a valid UUID, the server MUST return 400 Bad Request.

Success response

If the subscription is successfully deleted:

• HTTP Status: 204 No Content
• The response MUST NOT include a body.

HTTP/1.1 204 No Content

Error responses

See error response format for more information.