Skip to content
RosettaChat Docs

Login

POST
/api/v1/auth/web/login

Authenticate user with email and password, establish a session.

Request Body required

Section titled “Request Body required ”
object
email
required

The user’s email address.

string
john@example.com
password
required

The user’s password.

string
secretpassword
device_name

Must not be greater than 255 characters.

string
v

Responses

Section titled “ Responses ”

200

Section titled “200 ”
object
user
object
id
integer
1
name
string
John Doe
email
string
john@example.com
message
string
Logged in successfully.
{
  "user": {
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com"
  },
  "message": "Logged in successfully."
}

403

Section titled “403 ”

Account inactive

object
message
string
Account is inactive.
{
  "message": "Account is inactive."
}

422

Section titled “422 ”

Invalid credentials

object
message
string
The given data was invalid.
errors
object
email
Array<string>
[
  "The provided credentials are incorrect."
]
{
  "message": "The given data was invalid.",
  "errors": {
    "email": [
      "The provided credentials are incorrect."
    ]
  }
}