PATCH /outfits/{outfit_id} — Update outfit metadata

Call PATCH /outfits/{outfit_id} to update an existing outfit. You can change the name, visibility, favorite status, seasons, tags, or the entire canvas scene. Only include the fields you want to modify — any field you omit remains unchanged. If you supply a new scene, it replaces the existing scene in full.

Endpoint

Field	Value
Method	`PATCH`
Path	`/outfits/{outfit_id}`
Auth required	Yes (Bearer token)
Rate limit	3 per minute

Path parameters

outfit_id

string

required

The ID of the outfit to update.

Request body

All fields are optional. Include only the fields you want to change.

name

string

New display name for the outfit.

is_public

boolean

Set to true to make the outfit visible to other users, or false to make it private.

is_favorite

boolean

Set to true to mark the outfit as a favorite, or false to remove the favorite status.

seasons

string[]

Replaces the current seasons list. Accepted values: Spring, Summer, Autumn, Winter.

Response fields

Status: 200 OK

item

object

required

The updated outfit object.

Show Outfit object properties

outfit_id

string

required

Unique identifier for the outfit.

user_id

string

required

ID of the user who owns this outfit.

name

string

required

Display name of the outfit.

description

string

Optional description of the outfit.

is_public

boolean

required

Whether the outfit is visible to other users.

is_favorite

boolean

required

Whether the outfit is marked as a favorite.

seasons

string[]

Seasons assigned to the outfit.

Example

cURL

curl --request PATCH \
  --url https://api.drssed.com/outfits/otf_abc123 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Weekend Brunch (Updated)",
    "is_favorite": true,
    "tags": ["Casual", "Outdoor"]
  }'

Response

{
  "item": {
    "outfit_id": "otf_abc123",
    "user_id": "usr_xyz789",
    "name": "Weekend Brunch (Updated)",
    "description": "Relaxed but put-together.",
    "is_public": true,
    "is_favorite": true,
    "seasons": ["Spring", "Summer"],
    "tags": ["Casual", "Outdoor"],
    "scene": [
      {
        "clothing_id": "clth_shirt_001",
        "x": 0.5,
        "y": 0.3,
        "z": 2,
        "scale": 1.0,
        "rotation": 0.0
      }
    ],
    "created_at": "2024-06-20T14:00:00+00:00",
    "updated_at": "2024-06-21T09:45:00+00:00"
  }
}

This endpoint is rate limited to 3 requests per minute — lower than other outfit endpoints. If you need to make several updates in quick succession, batch your changes into a single request where possible.

Auth

Wardrobe

Outfits

Images

Sync

Account

PATCH /outfits/{outfit_id} — Update outfit metadata

Endpoint

Path parameters

Request body

Response fields

Example

​Endpoint

​Path parameters

​Request body

​Response fields

​Example

Endpoint

Path parameters

Request body

Response fields

Example