---
title: "Initiate login with the default authentication session provider."
method: POST
path: "/auth/login"
tags: ["authentication"]
---

# Initiate login with the default authentication session provider.

`POST /auth/login`

## Response `200`

successful operation

- union
  - LoginSuccess
    - `type` 'success', required
    - `username` string, required
  - LoginRedirect
    - `type` 'redirect', required
    - `url` string, required

## Changes

- **2026-07-17** `7bb29d87d3d8` — 1 info
  - removed response discriminator for the response status `200`
- **2023-10-03** `a6f4e3063618` — 1 info
  - added response discriminator for the response status `200`

[Change history](https://skmtc.dev/openrailassociation/apis/osrd-gateway/changes/auth/login/post.md)

---

[API](https://skmtc.dev/openrailassociation/apis/osrd-gateway.md) · [All operations](https://skmtc.dev/openrailassociation/apis/osrd-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openrailassociation/osrd-gateway/revisions/7bb29d87d3d8/schema)