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

# POST /users/me/clothing — Add a clothing item to wardrobe

> Add a new clothing item to your wardrobe. Requires an image_id from the image processing endpoint. Returns the created clothing object.

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

| Field         | Value                |
| ------------- | -------------------- |
| Method        | `POST`               |
| Path          | `/users/me/clothing` |
| Auth required | Yes — Bearer token   |
| Rate limit    | 5 per minute         |

## Request body

<ParamField body="name" type="string" required>
  Display name of the clothing item.
</ParamField>

<ParamField body="category" type="string" required>
  Category of the item. One of: `JACKET`, `TOP`, `BOTTOM`, `FOOTWEAR`.
</ParamField>

<ParamField body="image_id" type="string">
  ID of an image to associate with this item. Obtain this from `POST /images/preview`.
</ParamField>

<ParamField body="color" type="string">
  Color of the item (e.g. `"Navy Blue"`).
</ParamField>

<ParamField body="seasons" type="array">
  Seasons the item is suited for. Accepted values: `Spring`, `Summer`, `Autumn`, `Winter`.
</ParamField>

<ParamField body="tags" type="array">
  Style tags for the item. Accepted values: `Casual`, `Formal`, `Sports`, `Vintage`.
</ParamField>

<ParamField body="description" type="string">
  Free-text description of the item.
</ParamField>

## Response fields

**Status: 201 Created**

<ResponseField name="clothing" type="object" required>
  The newly created clothing object.

  <Expandable title="Clothing object properties">
    <ResponseField name="clothing_id" type="string" required>
      Unique identifier for the clothing item.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Display name of the item.
    </ResponseField>

    <ResponseField name="category" type="string" required>
      Category of the item. One of: `JACKET`, `TOP`, `BOTTOM`, `FOOTWEAR`.
    </ResponseField>

    <ResponseField name="color" type="string" required>
      Color of the item.
    </ResponseField>

    <ResponseField name="is_public" type="boolean" required>
      Whether the item is visible to other users.
    </ResponseField>

    <ResponseField name="user_id" type="string" required>
      ID of the user who owns the item.
    </ResponseField>

    <ResponseField name="image_id" type="string" required>
      ID of the associated image.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      ISO 8601 timestamp of when the item was created.
    </ResponseField>

    <ResponseField name="seasons" type="array">
      Seasons the item is suited for.
    </ResponseField>

    <ResponseField name="tags" type="array">
      Style tags applied to the item.
    </ResponseField>

    <ResponseField name="description" type="string">
      Free-text description of the item.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash cURL theme={null}
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"
  }'
```

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