---
title: "Admin Login"
method: POST
path: "/api/v1/auth/login"
tags: ["Auth"]
---

# Admin Login

`POST /api/v1/auth/login`

## Request body

- object
  - `username` string, required
  - `password` string, required

## Response `200`

Login successful, sets httpOnly cookie

- object — Login successful, sets httpOnly cookie
  - `success` boolean, required
  - `data` object, required
    - `id` integer
    - `username` string
    - `displayName` string, nullable
    - `role` object
      - `id` integer
      - `name` string
      - `isSystem` boolean
    - `permissions` string[]

## Other responses

- `401` — Invalid username or password
- `429` — Too many failed attempts — IP temporarily locked

---

[API](https://skmtc.dev/newapi/apis/qn-platform-api.md) · [All operations](https://skmtc.dev/newapi/apis/qn-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newapi/qn-platform-api/revisions/d61f11e363ff/schema)