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

# PATCH /clothing/{clothing_id} — Update a clothing item

> Update one or more fields of a clothing item. All request body fields are optional — only the fields you provide will be updated.

Call `PATCH /clothing/{clothing_id}` to update an existing clothing item. You only need to include the fields you want to change — any field you omit will remain unchanged. To replace the full seasons or tags list, pass the complete new array; the existing values will be overwritten.

## Endpoint

| Field         | Value                     |
| ------------- | ------------------------- |
| Method        | `PATCH`                   |
| Path          | `/clothing/{clothing_id}` |
| Auth required | Yes — Bearer token        |
| Rate limit    | 5 per minute              |

## Path parameters

<ParamField path="clothing_id" type="string" required>
  UUID of the clothing item to update.
</ParamField>

## Request body

All fields are optional. Only the fields you include will be updated.

<ParamField body="name" type="string">
  New display name for the item.
</ParamField>

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

<ParamField body="color" type="string">
  New color for the item.
</ParamField>

<ParamField body="seasons" type="array">
  Replaces the entire seasons array. Accepted values: `Spring`, `Summer`, `Autumn`, `Winter`.
</ParamField>

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

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

<ParamField body="description" type="string">
  New free-text description for the item.
</ParamField>

## Response fields

**Status: 200 OK**

<ResponseField name="clothing" type="object" required>
  The updated 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 PATCH \
  --url https://api.drssed.com/clothing/clth_a1b2c3d4e5f6 \
  --header "Authorization: Bearer <token>" \
  --header "Content-Type: application/json" \
  --data '{
    "color": "Light Blue",
    "seasons": ["Spring", "Summer"],
    "tags": ["Casual"]
  }'
```

```json Response theme={null}
{
  "clothing": {
    "clothing_id": "clth_a1b2c3d4e5f6",
    "name": "White Oxford Shirt",
    "category": "TOP",
    "color": "Light Blue",
    "is_public": true,
    "user_id": "usr_9z8y7x6w",
    "image_id": "img_f1e2d3c4",
    "created_at": "2025-03-14T10:22:00+00:00",
    "seasons": ["Spring", "Summer"],
    "tags": ["Casual"],
    "description": "Classic slim-fit Oxford button-down."
  }
}
```