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

# Login

`POST /api/identity/auth/login`

## Request

- Base URL: `https://api.superit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.superit.ai/api/identity/auth/login`
- Auth: none declared

Authenticate user and return JWT tokens.

## Request body

- LoginRequest: Login request.
  - `email` string, email, required
  - `password` string, required

## Response `200`

Successful Response

- LoginResponse: Login response with user, teams, and tokens.
  - `user` UserResponse, required: User data for API responses.
    - `key` string, required
    - `email` string, required
    - `firstName` string
    - `lastName` string
    - `fullName` string
    - `nickname` string
    - `displayName` string
    - `avatarUrl` string, nullable
    - `lastLogin` string, nullable
    - `phoneNumber` string
    - `timezone` string
    - `language` string, nullable
  - `teams` TeamResponse[], required
    - `key` string, required
    - `name` string, required
    - `slug` string, required
    - `type` 'normal' | 'service-provider' | 'managed', required: Supported team types.
    - `parentTeamId` integer, nullable
    - `timezone` string, required
    - `language` string, required
  - `tokens` TokenPair, required: JWT token pair.
    - `access` string, required
    - `refresh` string, required
  - `defaultTeamKey` string, nullable
  - `isFirstLogin` boolean

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error
- `429`: Too many requests

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)