POST /users/me/outfits — Create a new outfit record

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

Field	Value
Method	`POST`
Path	`/users/me/outfits`
Auth required	Yes (Bearer token)
Rate limit	5 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.

Response fields

Status: 201 Created

outfit

object

required

The newly created 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 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"
  }
}

Auth

Wardrobe

Outfits

Images

Sync

Account

POST /users/me/outfits — Create a new outfit record

Endpoint

Request body

Response fields

Example

​Endpoint

​Request body

​Response fields

​Example

Endpoint

Request body

Response fields

Example