Skip to content

LoginRequest

Defined in: src/@types/auth.ts:145

Request body for POST /login request

https://spec.matrix.org/v1.7/client-server-api/#post_matrixclientv3login

[key: string]: any

optional device_id?: string

Defined in: src/@types/auth.ts:156

ID of the client device. If this does not correspond to a known client device, a new device will be created. The given device ID must not be the same as a cross-signing key ID. The server will auto-generate a device_id if this is not specified.


optional identifier?: UserIdentifier

Defined in: src/@types/auth.ts:160

Identification information for a user


optional initial_device_display_name?: string

Defined in: src/@types/auth.ts:165

A display name to assign to the newly-created device. Ignored if device_id corresponds to a known device.


optional medium?: "email"

Defined in: src/@types/auth.ts:171

When logging in using a third-party identifier, the medium of the identifier. Must be email.


optional password?: string

Defined in: src/@types/auth.ts:175

Required when type is m.login.password. The user’s password.


optional refresh_token?: boolean

Defined in: src/@types/auth.ts:179

If true, the client supports refresh tokens.


optional token?: string

Defined in: src/@types/auth.ts:183

Required when type is m.login.token. Part of Token-based login.


type: string

Defined in: src/@types/auth.ts:149

The login type being used.


optional user?: string

Defined in: src/@types/auth.ts:188

The fully qualified user ID or just local part of the user ID, to log in.