# REST-API: Auth

> Die 8 Operationen des Bereichs Auth, mit Parametern, Bodys und Antworten.

Source: https://pithyx.org/de/docs/reference/api/auth/
Markdown: https://pithyx.org/de/docs/reference/api/auth.md

Erzeugt aus dem OpenAPI-Dokument des Daemons. Konventionen, Anmeldung, der CSRF-Header und der WebSocket stehen unter [API](https://pithyx.org/de/docs/developers/daemon/api/).

## POST /api/auth/login

**Anfrage-Body**: `application/json`: [LoginRequest](https://pithyx.org/de/docs/reference/api/schemas/#loginrequest)

**Antworten**

- 200: `application/json`: [LoginResponse](https://pithyx.org/de/docs/reference/api/schemas/#loginresponse)

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## POST /api/auth/login/totp

**Anfrage-Body**: `application/json`: [TotpLoginRequest](https://pithyx.org/de/docs/reference/api/schemas/#totploginrequest)

**Antworten**

- 200: `application/json`: [UserInfo](https://pithyx.org/de/docs/reference/api/schemas/#userinfo)

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## POST /api/auth/logout

**Antworten**

- 204

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## POST /api/auth/recover

**Anfrage-Body**: `application/json`: [RecoverRequest](https://pithyx.org/de/docs/reference/api/schemas/#recoverrequest)

**Antworten**

- 200: `application/json`: [RecoverResponse](https://pithyx.org/de/docs/reference/api/schemas/#recoverresponse)

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## GET /api/auth/session

**Antworten**

- 200: `application/json`: [UserInfo](https://pithyx.org/de/docs/reference/api/schemas/#userinfo)

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## POST /api/auth/totp/confirm

**Anfrage-Body**: `application/json`: [TotpConfirmRequest](https://pithyx.org/de/docs/reference/api/schemas/#totpconfirmrequest)

**Antworten**

- 200: `application/json`: [RecoveryCodes](https://pithyx.org/de/docs/reference/api/schemas/#recoverycodes)

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## POST /api/auth/totp/disable

**Anfrage-Body**: `application/json`: [TotpDisableRequest](https://pithyx.org/de/docs/reference/api/schemas/#totpdisablerequest)

**Antworten**

- 204

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## POST /api/auth/totp/enroll

**Antworten**

- 200: `application/json`: [TotpEnrollment](https://pithyx.org/de/docs/reference/api/schemas/#totpenrollment)

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).