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 POST /users/me/outfits to create a new outfit. You can assemble a canvas scene by placing clothing items at specific coordinates, layer orders, and rotations. All fields except name are optional — you can create an empty outfit and populate the scene later using PATCH /outfits/.

Endpoint

FieldValue
MethodPOST
Path/users/me/outfits
Auth requiredYes (Bearer token)
Rate limit5 per minute

Request body

name
string
required
Display name for the outfit.
description
string
Optional free-text description of the outfit.
is_public
boolean
default:"false"
Whether the outfit is visible to other users.
is_favorite
boolean
default:"false"
Whether to mark the outfit as a favorite.
seasons
string[]
Seasons the outfit is suitable for. Accepted values: Spring, Summer, Autumn, Winter.
tags
string[]
Style tags for the outfit. Accepted values: Casual, Formal, Sports, Vintage, Outdoor, Party, Work, Beach.
scene
object[]
Array of CanvasPlacement objects that define the visual layout of the outfit. Each object positions one clothing item on the canvas.

Response fields

Status: 201 Created
outfit
object
required
The newly created outfit object.

Example

cURL
curl --request POST \
  --url https://api.drssed.com/users/me/outfits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Weekend Brunch",
    "description": "Relaxed but put-together.",
    "is_public": true,
    "is_favorite": false,
    "seasons": ["Spring", "Summer"],
    "tags": ["Casual"],
    "scene": [
      {
        "clothing_id": "clth_shirt_001",
        "x": 0.5,
        "y": 0.3,
        "z": 2,
        "scale": 1.0,
        "rotation": 0.0
      },
      {
        "clothing_id": "clth_pants_002",
        "x": 0.5,
        "y": 0.7,
        "z": 1,
        "scale": 1.0,
        "rotation": 0.0
      }
    ]
  }'
Response
{
  "outfit": {
    "outfit_id": "otf_abc123",
    "user_id": "usr_xyz789",
    "name": "Weekend Brunch",
    "description": "Relaxed but put-together.",
    "is_public": true,
    "is_favorite": false,
    "seasons": ["Spring", "Summer"],
    "tags": ["Casual"],
    "scene": [
      {
        "clothing_id": "clth_shirt_001",
        "x": 0.5,
        "y": 0.3,
        "z": 2,
        "scale": 1.0,
        "rotation": 0.0
      },
      {
        "clothing_id": "clth_pants_002",
        "x": 0.5,
        "y": 0.7,
        "z": 1,
        "scale": 1.0,
        "rotation": 0.0
      }
    ],
    "created_at": "2024-06-20T14:00:00+00:00",
    "updated_at": "2024-06-20T14:00:00+00:00"
  }
}