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.

Creates a new custom collectable status for the authenticated user. Requires elite membership.

​
Endpoint

POST /api/v1/users/:id/statuses

​
Parameters

​
id
string
required
The ID of the user creating the status (must be the authenticated user).

​
Request Body

​
status.name
string
required
The name of the status (e.g., “Gift”, “Investment”, “Daily Drinker”).
​
status.color
string
required
The hex color code for the status (e.g., “#e83e8c”, “#17a2b8”).
curl -X POST https://api.onlydrams.app/api/v1/users/123e4567-e89b-12d3-a456-426614174000/statuses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
    "status": {
      "name": "Gift",
      "color": "#e83e8c"
    }
  }'

{
  "message": "Status created successfully"
}

​
Error Responses

{
  "error": "Elite membership required to create custom statuses"
}

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

{
  "error": "Name has already been taken"
}