---
title: "POST /auth/login/"
method: POST
path: "/auth/login/"
tags: ["auth"]
---

# POST /auth/login/

`POST /auth/login/`

## Request body

- LoginSchema
  - `login` string, required
  - `password` string, required
  - `undelete` boolean
  - `captcha_key` string
  - `login_source` string
  - `gift_code_sku_id` string

## Response `200`

- union
  - TokenResponse
    - `token` string, required
    - `settings` UserSettings, required
      - `index` string, required
      - `afk_timeout` integer, required
      - `allow_accessibility_detection` boolean, required
      - `animate_emoji` boolean, required
      - `animate_stickers` integer, required
      - `contact_sync_enabled` boolean, required
      - `convert_emoticons` boolean, required
      - `custom_status` CustomStatus, required
        - `emoji_id` string
        - `emoji_name` string
        - `expires_at` integer
        - `text` string
      - `default_guilds_restricted` boolean, required
      - `detect_platform_accounts` boolean, required
      - `developer_mode` boolean, required
      - `disable_games_tab` boolean, required
      - `enable_tts_command` boolean, required
      - `explicit_content_filter` integer, required
      - `friend_discovery_flags` integer, required
      - `friend_source_flags` FriendSourceFlags, required
        - `all` boolean, required
      - `gateway_connected` boolean, required
      - `gif_auto_play` boolean, required
      - `guild_folders` GuildFolder[], required
        - `color` integer, nullable
        - `guild_ids` string[], required
        - `id` integer, nullable
        - `name` string, nullable
      - `guild_positions` string[], required
      - `inline_attachment_media` boolean, required
      - `inline_embed_media` boolean, required
      - `locale` string, required
      - `message_display_compact` boolean, required
      - `native_phone_integration_enabled` boolean, required
      - `render_embeds` boolean, required
      - `render_reactions` boolean, required
      - `restricted_guilds` string[], required
      - `show_current_game` boolean, required
      - `status` 'dnd' | 'idle' | 'invisible' | 'offline' | 'online', required
      - `stream_notifications_enabled` boolean, required
      - `theme` 'dark' | 'light', required
      - `timezone_offset` integer, required
      - `view_nsfw_guilds` boolean, required
  - MFAResponse
    - `ticket` string, required
    - `mfa` true, required
    - `sms` false, required
    - `token` unknown, required
  - WebAuthnResponse
    - `webauthn` string, required
    - `ticket` string, required
    - `mfa` true, required
    - `sms` false, required
    - `token` unknown, required

## Other responses

- `400`

## Changes

- **2026-04-28** `d209eb052880` — 1 info
  - endpoint added
- **2026-04-19** `1cde78e24558` — 1 breaking
  - api path removed without deprecation
- **2026-03-16** `0fa8e94de7e7` — 1 breaking
  - removed the required property `anyOf[#/components/schemas/TokenResponse]/settings/__@annotationsKey@12300` from the response with the `200` status
- **2026-03-14** `f3ce58d12e93` — 1 breaking, 1 info
  - removed the required property `anyOf[#/components/schemas/TokenResponse]/settings/__@annotationsKey@12306` from the response with the `200` status
  - added the required property `anyOf[#/components/schemas/TokenResponse]/settings/__@annotationsKey@12300` to the response with the `200` status
  - …this revision’s changelog is incomplete
- **2026-03-14** `eaad628663dc` — 1 breaking, 1 info
  - removed the required property `anyOf[#/components/schemas/TokenResponse]/settings/__@annotationsKey@12309` from the response with the `200` status
  - added the required property `anyOf[#/components/schemas/TokenResponse]/settings/__@annotationsKey@12306` to the response with the `200` status
  - …this revision’s changelog is incomplete

[Full history](https://skmtc.dev/spacebarchat/apis/spacebar-server/changes/auth/login/post.md)

---

[API](https://skmtc.dev/spacebarchat/apis/spacebar-server.md) · [All operations](https://skmtc.dev/spacebarchat/apis/spacebar-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spacebarchat/spacebar-server/revisions/a15db2c050e7/schema)