> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handauncle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User Profile API

> Profile card collection and user data for personalized AI responses.

The user profile system collects information through interactive cards shown during
chat sessions. This data personalizes AI responses without explicitly repeating it
back to the user.

### Quick facts

* User profile base path: `/api/v1/user-profile`
* Auth: Required for all endpoints
* MongoDB collection: `user_profiles`
* Cards shown 2 at a time, advancing each session

### Surface area

| Action        | Endpoint                                                            | Description                            |
| ------------- | ------------------------------------------------------------------- | -------------------------------------- |
| Get profile   | [`GET /api/v1/user-profile`](./user-profile/get)                    | User profile + current cards to show   |
| Save answers  | [`POST /api/v1/user-profile/answers`](./user-profile/save-answers)  | Store card responses                   |
| Start session | [`POST /api/v1/user-profile/session`](./user-profile/start-session) | Begin new session, advance cards       |
| Get cards     | [`GET /api/v1/user-profile/cards`](./user-profile/get-cards)        | Current cards without starting session |

See the endpoint pages for request bodies, parameter constraints, and example
responses pulled directly from the OpenAPI schema.