Log in

Verify account credentials and issue a secure dashboard session cookie.

Endpoint

POST/api/v1/auth/login

Authentication

Operation class	Authentication	Minimum role	API key
dashboard-session-api	No authentication.	none	Not allowed

Parameters

This operation has no path, query, or header parameters.

Request body

application/json request schema

Field path	Type	Reference	Format	Nullable	Required	Enum	Description
`$`	object	PermintaanMasuk	—	No	Yes	—	—
`email`	string	—	email	No	Yes	—	—
`password`	string	—	—	No	Yes	—	—
`remember`	boolean	—	—	No	No	—	—

Example

curl --request POST 'https://operade.ai/api/v1/auth/login' \
  --header 'Content-Type: application/json' \
  --data '{"email":"alex@example.com","password":"EXAMPLE_PASSWORD_16","remember":false}'

{
  "email": "alex@example.com",
  "password": "EXAMPLE_PASSWORD_16",
  "remember": false
}

Responses

Status	Description	Content
`4XX`	Handled client error	application/json: ErrorResponse
`200`	Successful Response	application/json: LoginResponse

4XX application/json response schema

Field path	Type	Reference	Format	Nullable	Required	Enum	Description
`$`	object	ErrorResponse	—	No	Yes	—	—
`error`	object	ErrorItem	—	No	Yes	—	—
`error.code`	string	—	—	No	Yes	—	—
`error.details`	object	—	—	No	No	—	—
`error.message`	string	—	—	No	Yes	—	—

200 application/json response schema

Field path	Type	Reference	Format	Nullable	Required	Enum	Description
`$`	object	LoginResponse	—	No	Yes	—	—
`status`	string	—	—	No	Yes	"masuk"	—

Response example

{
  "status": "masuk"
}

Errors

Reviewed common and route-declared errors are summarized here; the list is not exhaustive. Start with the distributed error index to find each code's canonical domain page.

Status	Code	Description
`401`	`unauthenticated`	Authentication is missing, invalid, or revoked.
`422`	`validation_failed`	The request did not pass field or business validation.
`429`	`rate_limited`	Too many attempts were made within the active limit window.