Skip to main content

Documentation Index

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

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

Call POST /users/me/clothing to add a new item to your wardrobe. You must supply a name and a category. All other fields, including image_id, are optional. To attach an image, first upload it via POST /images/preview and pass the returned image_id in the request body.

​
Endpoint

FieldValue
MethodPOST
Path/users/me/clothing
Auth requiredYes — Bearer token
Rate limit5 per minute

​
Request body

​
name
string
required
Display name of the clothing item.
​
category
string
required
Category of the item. One of: JACKET, TOP, BOTTOM, FOOTWEAR.
​
image_id
string
ID of an image to associate with this item. Obtain this from POST /images/preview.
​
color
string
Color of the item (e.g. "Navy Blue").
​
seasons
array
Seasons the item is suited for. Accepted values: Spring, Summer, Autumn, Winter.
​
tags
array
Style tags for the item. Accepted values: Casual, Formal, Sports, Vintage.
​
description
string
Free-text description of the item.

​
Response fields

Status: 201 Created
​
clothing
object
required
The newly created clothing object.

​
Example

cURL
curl --request POST \
  --url https://api.drssed.com/users/me/clothing \
  --header "Authorization: Bearer <token>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Navy Chinos",
    "category": "BOTTOM",
    "color": "Navy",
    "seasons": ["Spring", "Autumn"],
    "tags": ["Casual", "Formal"],
    "description": "Slim-fit navy chinos.",
    "image_id": "img_f1e2d3c4"
  }'
Response
{
  "clothing": {
    "clothing_id": "clth_a1b2c3d4e5f6",
    "name": "Navy Chinos",
    "category": "BOTTOM",
    "color": "Navy",
    "is_public": false,
    "user_id": "usr_9z8y7x6w",
    "image_id": "img_f1e2d3c4",
    "created_at": "2025-04-01T08:15:00+00:00",
    "seasons": ["Spring", "Autumn"],
    "tags": ["Casual", "Formal"],
    "description": "Slim-fit navy chinos."
  }
}