---
title: "Authenticate with email and password"
method: POST
path: "/auth/login"
tags: ["auth"]
---

# Authenticate with email and password

`POST /auth/login`

## Request

- The document declares no server URL.
- Auth: none declared

Verifies credentials and returns a 24-hour session token. Revokes any existing session for the user.

## Request body

- InternalApiAdminLoginRequest
  - `email` string
  - `password` string

## Response `200`

OK

- InternalApiAdminLoginResponse
  - `expires_at` string
  - `token` string
  - `user` InternalApiAdminMeResponse
    - `display_name` string
    - `email` string
    - `id` string
    - `is_system_admin` boolean
    - `org_id` string
    - `role` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/voidmind-io/apis/voidmind-voidllm-api.md) - [All operations](https://skmtc.dev/voidmind-io/apis/voidmind-voidllm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voidmind-io/apis/voidmind-voidllm-api/revisions/1405e7d9c155?raw)
