Users API

GET /api/users/:user_id

{
  "id": "user-uuid",
  "username": "user123",
  "discriminator": "1234",
  "avatar": "https://...",
  "banner": "https://...",
  "bio": "Hello world!",
  "is_premium": false,
  "created_at": "2024-01-01T00:00:00Z",
  "custom_status": {
    "text": "Playing games",
    "emoji": "🎮",
    "expires_at": null
  }
}

PATCH /api/users/:user_id/profile
Authorization: Bearer TOKEN

{
  "bio": "New bio",
  "avatar": "https://...",
  "banner": "https://...",
  "pronouns": "they/them",
  "timezone": "America/New_York"
}

POST /api/upload/avatar
Authorization: Bearer TOKEN
Content-Type: multipart/form-data

{
  "url": "/api/files/file-uuid",
  "file_id": "file-uuid"
}

POST /api/upload/banner
Authorization: Bearer TOKEN
Content-Type: multipart/form-data

PATCH /api/users/:user_id/status
Authorization: Bearer TOKEN

{
  "text": "Playing games",
  "emoji": "🎮",
  "expires_at": "2024-01-02T00:00:00Z"
}

{
  "text": null,
  "emoji": null
}

PATCH /api/users/:user_id/privacy
Authorization: Bearer TOKEN

{
  "allow_friend_requests": true,
  "allow_dms_from_non_friends": false,
  "show_online_status": true
}

GET /api/users/:current_user_id/mutual-guilds/:target_user_id
Authorization: Bearer TOKEN

[
  {
    "id": "guild-uuid",
    "name": "Shared Server",
    "icon": "https://..."
  }
]

GET /api/users/:current_user_id/mutual-friends/:target_user_id
Authorization: Bearer TOKEN

POST /api/presence
Authorization: Bearer TOKEN

{
  "status": "online",
  "custom_status": "Playing games"
}

POST /api/presence/heartbeat
Authorization: Bearer TOKEN

GET /api/presence/:user_id

{
  "user_id": "user-uuid",
  "status": "online",
  "last_seen": "2024-01-01T00:00:00Z"
}

GET /api/files/:file_id