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

# POST /auth

`POST /auth`

Returns a JWT Token and UUID attached to user

## Request body

- UserLogin
  - `password` string, required
  - `username` string, required

## Response `201`

UserLoginSuccessResponse

- UserLoginSuccessResponse
  - `scope` string — the uuid
  - `token` string — the token
  - `user` object — the uuid
    - `admin` boolean

## Other responses

- `400` — FailureResponse

## Changes

> 16 revisions in range; 1 could not be searched.

- **2021-11-03** `31e15898198d` — 1 info
  - api tag `auth` removed
- **2021-10-08** `d39f8246865f` — 2 info
  - added the non-success response with the status `400`
  - added the success response with the status `201`
- **2020-04-01** `8739183b4c43` — 2 info
  - api operation id `userLogin` removed and replaced with `userLoginUser`
  - api tag `auth` added
- **2020-01-30** `74c42b4c88d5` — 1 info
  - api operation id `userlogin` removed and replaced with `userLogin`
- **2020-01-29** `0afee0047c89` — 2 warning
  - deleted the `query` request parameter `password`
  - deleted the `query` request parameter `username`

[Full history](https://skmtc.dev/sipcapture/apis/homer-app/changes/auth/post.md)

---

[API](https://skmtc.dev/sipcapture/apis/homer-app.md) · [All operations](https://skmtc.dev/sipcapture/apis/homer-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipcapture/homer-app/revisions/2f261ecc6074/schema)