Skip to main content

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.

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

FieldValue
MethodPATCH
Path/outfits/{outfit_id}
Auth requiredYes (Bearer token)
Rate limit3 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.
​
tags
string[]
Replaces the current tags list. Accepted values: Casual, Formal, Sports, Vintage, Outdoor, Party, Work, Beach.
​
scene
object[]
Replaces the entire canvas scene. Provide an array of CanvasPlacement objects.

​
Response fields

Status: 200 OK
​
item
object
required
The updated outfit object.

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