Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt

Use this file to discover all available pages before exploring further.

Deletes a custom collectable status. System-created statuses cannot be deleted.

​
Endpoint

DELETE /api/v1/users/:id/statuses/:status_id

​
Parameters

​
id
string
required
The ID of the user who owns the status (must be the authenticated user).
​
status_id
string
required
The ID of the status to delete.
curl -X DELETE https://api.onlydrams.app/api/v1/users/123e4567-e89b-12d3-a456-426614174000/statuses/custom1 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

{
  "message": "Status deleted successfully"
}

​
Error Responses

{
  "error": "Cannot update or delete system-created statuses"
}

{
  "error": "Status not found"
}

{
  "error": "Cannot delete status that is currently in use"
}