Drssed API quickstart: your first wardrobe call

This page walks you through the four core actions you will take in almost every Drssed integration: getting an access token, processing a clothing image, saving the clothing item, and creating an outfit. You do not need an account — a guest session is enough to complete all four steps.

Access tokens expire after 1 hour. Store the refresh_token returned in step 1 and call POST /auth/refresh before the token expires to get a new one without losing your session. See Authentication for details.

Create a guest session

Call POST /auth/guest to receive a JWT access token instantly. No credentials required. The response includes an access_token valid for 1 hour, its expiry in seconds, and a refresh_token you can use to extend the session.

curl -X POST https://api.drssed.com/auth/guest

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600,
  "refresh_token": "dGhpcyBpcyBhIHNhbXBsZSByZWZyZXNo"
}

Use the access_token value as the Bearer token in all subsequent requests.

Upload a clothing image

Send a clothing photo to POST /images/preview as a multipart/form-data request with a file field. Drssed removes the background and uses AI to detect the item’s category, dominant color, suitable seasons, and style tags. The response includes an image_id you will use in the next step.

curl -X POST https://api.drssed.com/images/preview \
  -H "Authorization: Bearer {access_token}" \
  -F "[email protected]"

Response

{
  "image_url": "https://cdn.drssed.com/images/processed/abc123.png",
  "image_id": "img_abc123",
  "image_color": "Navy",
  "image_category": "JACKET",
  "image_seasons": ["Autumn", "Winter"],
  "image_tags": ["Casual", "Vintage"]
}

The image_category will be one of JACKET, TOP, BOTTOM, or FOOTWEAR. The image_seasons and image_tags values are AI-generated suggestions — you can override them when saving the item.

Save the clothing item

Use the image_id from the previous step to persist the clothing item to your wardrobe by calling POST /users/me/clothing. Supply the metadata you want to store — you can use the AI-suggested values or override them.

curl -X POST https://api.drssed.com/users/me/clothing \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Navy Denim Jacket",
    "category": "JACKET",
    "color": "Navy",
    "seasons": ["Autumn", "Winter"],
    "tags": ["Casual", "Vintage"],
    "image_id": "img_abc123"
  }'

Response

{
  "clothing": {
    "clothing_id": "clth_xyz789",
    "user_id": "usr_def456",
    "name": "Navy Denim Jacket",
    "category": "JACKET",
    "color": "Navy",
    "seasons": ["Autumn", "Winter"],
    "tags": ["Casual", "Vintage"],
    "image_id": "img_abc123",
    "is_public": false,
    "created_at": "2026-04-30T12:00:00+00:00"
  }
}

The clothing_id in the response is what you will reference when building outfits.

Create an outfit

Call POST /users/me/outfits to combine one or more clothing items into a named outfit. Use the scene field to store canvas placement data for each item — position, scale, rotation, and z-index — which lets clients render the outfit visually.

curl -X POST https://api.drssed.com/users/me/outfits \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekend look",
    "seasons": ["Autumn"],
    "tags": ["Casual"],
    "is_public": false,
    "is_favorite": false,
    "scene": [
      {
        "clothing_id": "clth_xyz789",
        "x": 0.5,
        "y": 0.3,
        "z": 1,
        "scale": 1.0,
        "rotation": 0.0
      }
    ]
  }'

Response

{
  "outfit": {
    "outfit_id": "outf_qrs321",
    "user_id": "usr_def456",
    "name": "Weekend look",
    "seasons": ["Autumn"],
    "tags": ["Casual"],
    "is_public": false,
    "is_favorite": false,
    "scene": [
      {
        "clothing_id": "clth_xyz789",
        "x": 0.5,
        "y": 0.3,
        "z": 1,
        "scale": 1.0,
        "rotation": 0.0
      }
    ],
    "created_at": "2026-04-30T12:01:00+00:00",
    "updated_at": "2026-04-30T12:01:00+00:00"
  }
}

Next steps

Read the Authentication page to learn how to refresh tokens, log in with a full account, and upgrade guest sessions.
Explore the API Reference for the full parameter and response schema for every endpoint.

Get Started

Core Concepts

Guides

Drssed API quickstart: your first wardrobe call

Next steps

​Next steps

Next steps