# Drssed API

## Docs

- [POST /auth/guest — Create a guest session instantly](https://docs.drssed.app/api/auth/guest.md): Create a guest access token and refresh token without registration. Rate limited to 5 requests per hour. Returns JWT access and refresh tokens.
- [POST /auth/login — Sign in with email or username/password](https://docs.drssed.app/api/auth/login.md): Authenticate with email or username and password. Returns an access token and refresh token. Rate limited to 5 requests per minute.
- [POST /auth/refresh — Exchange tokens for a new pair](https://docs.drssed.app/api/auth/refresh.md): Exchange a refresh token for a new access token and refresh token pair. Rate limited to 5 requests per minute. Both tokens are rotated.
- [POST /auth/signout — Sign out and invalidate a session](https://docs.drssed.app/api/auth/signout.md): Sign out by invalidating the refresh token. Requires a valid access token in the Authorization header. Rate limited to 2 requests per minute.
- [POST /auth/upgrade — Upgrade a guest to full account](https://docs.drssed.app/api/auth/upgrade.md): Convert a guest account to a full registered account by providing email, username, and password. Requires guest JWT. Rate limited to 5 per minute.
- [POST /users/me/clothing — Add a clothing item to wardrobe](https://docs.drssed.app/api/clothing/create.md): Add a new clothing item to your wardrobe. Requires an image_id from the image processing endpoint. Returns the created clothing object.
- [DELETE /clothing/{clothing_id} — Remove a clothing item](https://docs.drssed.app/api/clothing/delete.md): Soft-delete a clothing item from your wardrobe. The item is hidden immediately and will no longer appear in list or sync endpoint results.
- [GET /clothing/{clothing_id} — Retrieve a clothing item](https://docs.drssed.app/api/clothing/get.md): Retrieve a single clothing item by its ID. Returns the full clothing object including category, color, seasons, tags, and image reference.
- [GET /users/me/clothing — List clothing in your wardrobe](https://docs.drssed.app/api/clothing/list.md): Retrieve a paginated list of clothing items in your wardrobe. Supports filtering by category and pagination with limit and offset parameters.
- [PATCH /clothing/{clothing_id} — Update a clothing item](https://docs.drssed.app/api/clothing/update.md): Update one or more fields of a clothing item. All request body fields are optional — only the fields you provide will be updated.
- [POST /images/preview — Process and analyze clothing photo](https://docs.drssed.app/api/images/process.md): Upload a clothing photo for AI processing. Returns a background-removed image with auto-detected category, color, seasons, and style tags.
- [GET /uploads — Retrieve processed clothing image files](https://docs.drssed.app/api/images/retrieve.md): Retrieve processed clothing and outfit images using their IDs. Returns WebP images with background removed from the image processing step.
- [POST /users/me/outfits — Create a new outfit record](https://docs.drssed.app/api/outfits/create.md): Create a new outfit from existing clothing items. Define a canvas scene with item positions and metadata like seasons, tags, and visibility.
- [DELETE /outfits/{outfit_id} — Remove an outfit record](https://docs.drssed.app/api/outfits/delete.md): Soft-delete an outfit by ID. The outfit is immediately hidden from list and sync results. Requires authentication as the outfit owner.
- [GET /outfits/{outfit_id} — Retrieve a full outfit object](https://docs.drssed.app/api/outfits/get.md): Retrieve a single outfit by ID including its full scene layout, clothing item placements, tags, seasonal metadata, and favorite status.
- [GET /users/me/outfits — List outfits in your wardrobe](https://docs.drssed.app/api/outfits/list.md): Retrieve a paginated list of outfits. Use /users/me/outfits to include private outfits, or /users/{user_id}/outfits for public ones only.
- [PATCH /outfits/{outfit_id} — Update outfit metadata](https://docs.drssed.app/api/outfits/update.md): Update outfit metadata or rearrange the canvas scene. All fields are optional — only send the fields you want to change in the request body.
- [GET /users/me/clothing/sync — Incremental clothing sync](https://docs.drssed.app/api/sync/clothing.md): Incrementally sync clothing changes since a given timestamp. Returns updated items and deleted IDs along with a server_time for the next sync.
- [GET /users/me/outfits/sync — Incremental outfit sync](https://docs.drssed.app/api/sync/outfits.md): Incrementally sync outfit changes since a given timestamp. Returns updated outfits and deleted IDs, with a server_time for the next sync.
- [PUT /users/me/username — Change your username](https://docs.drssed.app/api/users/update-username.md): Update the username for your account. Must be unique across all users. Rate limited to 1 request per hour. Returns a success message on update.
- [Authentication: JWT tokens and guest sessions](https://docs.drssed.app/authentication.md): Drssed uses JWT Bearer tokens for all requests. Learn how to get a token, refresh it, sign out, and upgrade a guest account to a full account.
- [AI image processing: background removal and tagging](https://docs.drssed.app/concepts/image-processing.md): When you upload a photo, Drssed removes the background and uses AI to detect the dominant color, garment category, seasons, and style tags.
- [Outfits: combining clothing items in Drssed](https://docs.drssed.app/concepts/outfits.md): Outfits group clothing items into a named collection with a visual scene layout. Learn the data model, the scene concept, visibility, and the favorite flag.
- [Wardrobe and clothing items in Drssed](https://docs.drssed.app/concepts/wardrobe.md): A clothing item is the core data unit in Drssed. Learn about its fields, enumerations, visibility controls, and how pagination works across your wardrobe.
- [How to add and manage clothing items in Drssed](https://docs.drssed.app/guides/managing-clothing.md): Learn how to add, update, and delete clothing items via the Drssed API — from uploading an image to organizing your full wardrobe.
- [How to create and manage outfits with Drssed API](https://docs.drssed.app/guides/managing-outfits.md): Learn how to create outfits, build visual scenes from clothing items, and manage outfit metadata like seasons, tags, and visibility settings.
- [Incremental sync: keep wardrobe data up to date](https://docs.drssed.app/guides/syncing-data.md): Use the Drssed sync endpoints to fetch only what has changed since your last request — ideal for mobile and offline-first clients.
- [Drssed API: digitize, organize, and sync wardrobes](https://docs.drssed.app/introduction.md): Drssed API lets you digitize clothing, build outfits, and process images with AI. Built for developers adding wardrobe features to any app.
- [Drssed API quickstart: your first wardrobe call](https://docs.drssed.app/quickstart.md): Make your first Drssed API calls: create a guest session, upload a clothing image, save the item to a wardrobe, and build your first outfit.

## OpenAPI Specs

- [openapi](https://docs.drssed.app/api-reference/openapi.json)