Skip to main content
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.
A successful response returns everything you need to create the clothing item:
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
On success the API returns 201 Created with the new clothing object:
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.
The response lists matching items alongside your pagination parameters:
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
A successful update returns 200 OK with the updated item:
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.
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.