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.

Updates an existing custom collectable status. System-created statuses cannot be updated.

​
Endpoint

PATCH /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 update.

​
Request Body

​
status.name
string
The new name for the status.
​
status.color
string
The new hex color code for the status.
curl -X PATCH https://api.onlydrams.app/api/v1/users/123e4567-e89b-12d3-a456-426614174000/statuses/custom1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
    "status": {
      "name": "Birthday Gift",
      "color": "#ff6b6b"
    }
  }'

{
  "message": "Status updated successfully"
}

​
Error Responses

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

{
  "error": "Status not found"
}

{
  "error": "Name can't be blank"
}