> ## 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.

# Wardrobe and clothing items in Drssed

> A clothing item is the core data unit in Drssed. Learn about its fields, enumerations, visibility controls, and how pagination works across your wardrobe.

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

```json theme={null}
{
  "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"
}
```

<Note>
  The `image_id` field must be obtained from the response of `POST /images/preview` before you create a clothing item. See [AI image processing](/concepts/image-processing) for details.
</Note>