Wardrobe and clothing items in Drssed

Every piece you add to Drssed is stored as a clothing item — a structured record that describes a single garment with its category, color, seasons, tags, and a link to a processed image. Understanding this model helps you work with the wardrobe endpoints effectively, interpret responses correctly, and decide how to present data in your app.

The clothing item object

A clothing item has the following fields:

Field	Type	Description
`clothing_id`	string (UUID)	Unique identifier for the clothing item.
`name`	string	A display name for the item (e.g. `"Blue Oxford Shirt"`).
`category`	string (enum)	The garment category. One of `JACKET`, `TOP`, `BOTTOM`, or `FOOTWEAR`.
`color`	string	Dominant color — either a hex code (e.g. `"#3A86FF"`) or a color name (e.g. `"navy"`).
`seasons`	array of strings	The seasons the item suits. Any combination of `Spring`, `Summer`, `Autumn`, `Winter`.
`tags`	array of strings	Style tags. Any combination of `Casual`, `Formal`, `Sports`, `Vintage`.
`description`	string	Optional free-text description.
`image_id`	string	Reference to the processed image uploaded via `POST /images/preview`.
`is_public`	boolean	Whether the item is visible to other users.
`user_id`	string	The ID of the user who owns this item.
`created_at`	string (ISO 8601)	Timestamp of when the item was created, e.g. `"2025-09-01T14:30:00+00:00"`.

Category values

The category field uses a fixed set of values:

JACKET — outerwear including jackets and coats
TOP — anything worn on the upper body: shirts, t-shirts, sweaters, hoodies
BOTTOM — lower-body garments: jeans, trousers, shorts, skirts
FOOTWEAR — all footwear types: sneakers, boots, sandals, heels

Season and tag arrays

Both seasons and tags are optional arrays. You can assign multiple values — for example, a versatile jacket might carry ["Spring", "Autumn"], and a blazer might have ["Formal", "Vintage"].

Public and private items

The is_public flag controls visibility beyond the owning user. When is_public is false, the item is only accessible to its owner. Setting is_public to true makes the item retrievable by other authenticated users. You control is_public at creation time and can update it later via PATCH /clothing/{clothing_id}.

Pagination

The wardrobe list endpoint (GET /users/me/clothing) returns items in pages. Use the limit and offset query parameters to move through the collection:

Parameter	Type	Description
`limit`	integer	Maximum number of items to return in a single response.
`offset`	integer	Number of items to skip before starting to return results.

For example, to fetch the second page of 20 items, use ?limit=20&offset=20.

Example clothing item object

{
  "clothing_id": "c3d4e5f6-7890-abcd-ef01-234567890abc",
  "name": "Blue Oxford Shirt",
  "category": "TOP",
  "color": "#3A86FF",
  "seasons": ["Spring", "Summer"],
  "tags": ["Casual", "Formal"],
  "description": "A lightweight Oxford shirt, works well for smart-casual occasions.",
  "image_id": "img_a1b2c3d4e5f6",
  "is_public": false,
  "user_id": "u9f8e7d6c-5b4a-3210-fedc-ba9876543210",
  "created_at": "2025-09-01T14:30:00+00:00"
}

The image_id field must be obtained from the response of POST /images/preview before you create a clothing item. See AI image processing for details.

Get Started

Core Concepts

Guides

Wardrobe and clothing items in Drssed

The clothing item object

Category values

Season and tag arrays

Public and private items

Example clothing item object

​The clothing item object

​Category values

​Season and tag arrays

​Public and private items

​Pagination

​Example clothing item object

The clothing item object

Category values

Season and tag arrays

Public and private items

Pagination

Example clothing item object