Skip to main content
POST
/
auth
/
login
Login
curl --request POST \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/auth/login \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "someone@example.com",
  "password": "Testpassword"
}'
{
  "message": "Successful",
  "workspaces": [
    {
      "workspaceId": "7bd60554-4f63-4c62-a5f6-c29c3f67cb2a",
      "name": "Royalti Demo",
      "status": "active",
      "userType": [
        [
          "Artist"
        ]
      ],
      "role": "user"
    }
  ],
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRlNDI3MjllLWYxNGQtNDhlNy1iNGNiLWMxODliNmQxNThlNiIsIm5hbWUiOiJyZWZyZXNoX3Rva2VuIiwiaWF0IjoxNzA3MzAxNTAxLCJleHAiOjE3MDczODc5MDF9.TPEuW4Fuzycid1sGEeXGZseIK187QE5ECF92WDhcpHE"
}
/auth/login Description:
The /auth/login endpoint authenticates a user and returns an access token.
Rate Limiting:
This endpoint is rate limited to 20 requests per 3 minutes per IP address.
Method:
POST
Request Payload:
ParameterTypeDescriptionRequired
emailstringUser’s email addressYes
passwordstringUser’s passwordYes
rememberMebooleanWhether to extend the session durationNo
Response:
Returns an access token and user information on successful authentication.
Note: The access token should be included in the Authorization header as Bearer <token> for subsequent requests.
Security:
This endpoint requires no authentication.

Authentication

This endpoint requires authentication. Include your bearer token in the Authorization header.

Request Body

Request Schema

FieldTypeRequiredDescription
emailstringβœ…The email of the user
passwordstring❌The password associated with the username
loginTokenstring❌loginToken allows user to signin without using password

Responses

⚠️ 401 - Unauthorized

⚠️ 404 - Not Found

❌ 500 - Internal Server Error

Tags

Auth

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
email
string<email>
required

The email of the user

password
string

The password associated with the username

loginToken
string

loginToken allows user to signin without using password

Response

Success With LoginLink

message
string
workspaces
object[]
refresh_token
string
⌘I