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.

This guide walks you through the full lifecycle of a clothing item in the Drssed API. You will learn how to upload a clothing image and get AI-detected metadata back, create a clothing item using that image, list your wardrobe, update item details, and delete items you no longer need. Each step builds on the previous one, so you can follow along end-to-end or jump to the section you need.
The image_id used when creating a clothing item must come from a prior call to POST /images/preview. You cannot supply an arbitrary image URL or external identifier.
1

Process the clothing image

Before creating a clothing item, upload a photo of it to POST /images/preview. Drssed removes the background, detects the dominant color, infers the category, and returns suggested seasons and style tags — all automatically.Send the image as multipart/form-data with the field name file.
curl -X POST https://api.drssed.com/images/preview \
  -H "Authorization: Bearer {token}" \
  -F "file=@/path/to/jacket.jpg"
A successful response returns everything you need to create the clothing item:
{
  "image_url": "https://cdn.drssed.com/images/abc123.png",
  "image_id": "img_abc123",
  "image_color": "Navy Blue",
  "image_category": "JACKET",
  "image_seasons": ["Autumn", "Winter"],
  "image_tags": ["Casual", "Vintage"]
}
Use the AI-detected image_category, image_seasons, and image_tags as the default values when creating your clothing item. You can always override them, but the suggestions are accurate enough to use directly in most cases.
2

Create the clothing item

Call POST /users/me/clothing with the image_id from the previous step along with any metadata you want to store.Required fields: name, category, image_id, colorOptional fields: seasons, tags, descriptionValid category values: JACKET, TOP, BOTTOM, FOOTWEARValid seasons values: Spring, Summer, Autumn, WinterValid tags values: Casual, Formal, Sports, Vintage
curl -X POST https://api.drssed.com/users/me/clothing \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Navy Denim Jacket",
    "category": "JACKET",
    "image_id": "img_abc123",
    "color": "Navy Blue",
    "seasons": ["Autumn", "Winter"],
    "tags": ["Casual", "Vintage"],
    "description": "Slightly oversized, great for layering"
  }'
On success the API returns 201 Created with the new clothing object:
{
  "clothing": {
    "clothing_id": "clo_xyz789",
    "user_id": "usr_000111",
    "is_public": false,
    "name": "Navy Denim Jacket",
    "category": "JACKET",
    "color": "Navy Blue",
    "image_id": "img_abc123",
    "seasons": ["Autumn", "Winter"],
    "tags": ["Casual", "Vintage"],
    "description": "Slightly oversized, great for layering",
    "created_at": "2024-06-01T10:30:00+00:00"
  }
}
3

List your clothing

Retrieve your wardrobe with GET /users/me/clothing. Use limit and offset for pagination, and the optional category parameter to filter by type.
Query parameterTypeDefaultDescription
limitinteger50Number of items to return
offsetinteger0Number of items to skip
categorystring—Filter by JACKET, TOP, BOTTOM, or FOOTWEAR
curl https://api.drssed.com/users/me/clothing?limit=20&offset=0&category=JACKET \
  -H "Authorization: Bearer {token}"
The response lists matching items alongside your pagination parameters:
{
  "limit": 20,
  "offset": 0,
  "clothing": [
    {
      "clothing_id": "clo_xyz789",
      "name": "Navy Denim Jacket",
      "category": "JACKET",
      "color": "Navy Blue",
      "image_id": "img_abc123",
      "seasons": ["Autumn", "Winter"],
      "tags": ["Casual", "Vintage"],
      "description": "Slightly oversized, great for layering",
      "is_public": false,
      "user_id": "usr_000111",
      "created_at": "2024-06-01T10:30:00+00:00"
    }
  ]
}
4

Update a clothing item

Use PATCH /clothing/{clothing_id} to update any subset of fields on an existing item. All fields are optional — only the fields you include are changed.Updatable fields: name, category, color, seasons, tags, image_id, description
curl -X PATCH https://api.drssed.com/clothing/clo_xyz789 \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Navy Denim Jacket (oversized)",
    "seasons": ["Spring", "Autumn", "Winter"]
  }'
A successful update returns 200 OK with the updated item:
{
  "clothing": {
    "clothing_id": "clo_xyz789",
    "name": "Navy Denim Jacket (oversized)",
    "category": "JACKET",
    "color": "Navy Blue",
    "image_id": "img_abc123",
    "seasons": ["Spring", "Autumn", "Winter"],
    "tags": ["Casual", "Vintage"],
    "description": "Slightly oversized, great for layering",
    "is_public": false,
    "user_id": "usr_000111",
    "created_at": "2024-06-01T10:30:00+00:00"
  }
}
5

Delete a clothing item

Remove an item from your wardrobe with DELETE /clothing/{clothing_id}. The API performs a soft delete — the item is hidden from your wardrobe immediately but is not permanently erased right away.
curl -X DELETE https://api.drssed.com/clothing/clo_xyz789 \
  -H "Authorization: Bearer {token}"
A successful deletion returns 204 No Content with an empty body.

​
Rate limits

Most clothing endpoints are limited to 5 requests per minute. If you exceed this limit the API returns 429 Too Many Requests. Build a backoff strategy into your client if you expect bursts of requests.