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
Field Value Method POSTPath /users/me/outfitsAuth required Yes (Bearer token) Rate limit 5 per minute
Request body
Display name for the outfit.
Optional free-text description of the outfit.
Whether the outfit is visible to other users.
Whether to mark the outfit as a favorite.
Seasons the outfit is suitable for. Accepted values: Spring, Summer, Autumn, Winter.
Style tags for the outfit. Accepted values: Casual, Formal, Sports, Vintage, Outdoor, Party, Work, Beach.
Array of CanvasPlacement objects that define the visual layout of the outfit. Each object positions one clothing item on the canvas. Show CanvasPlacement properties
ID of the clothing item to place on the canvas.
Horizontal position of the item on the canvas.
Vertical position of the item on the canvas.
Layer order. Items with a higher z value appear on top of items with a lower value.
Size multiplier. A value of 1.0 renders the item at its default size.
Rotation of the item in degrees.
Response fields
Status: 201 Created
The newly created outfit object. Show Outfit object properties
Unique identifier for the outfit.
ID of the user who owns this outfit.
Display name of the outfit.
Optional description of the outfit.
Whether the outfit is visible to other users.
Whether the outfit is marked as a favorite.
Seasons assigned to the outfit.
Style tags assigned to the outfit.
Array of CanvasPlacement objects as submitted in the request.
ISO 8601 timestamp of when the outfit was created.
ISO 8601 timestamp of when the outfit was last updated.
Example
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
}
]
}'
{
"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"
}
}