Skip to content
Neuramancer API

User login

POST
/v1/auth/login
curl --request POST \
  --url https://api.neuramancer.dev/v1/auth/login \
  --header 'Content-Type: application/json' \
  --data '{ "email": "[email protected]", "password": "example" }'

Authenticates a user with email and password via Firebase, creates a custom token with enriched claims, and returns session tokens. No middleware authentication required.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
email
required

User’s email address

string format: email
password
required

User’s password

string
Examplegenerated
{
  "email": "[email protected]",
  "password": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

Login successful

Media typeapplication/json

Standardized success response containing session tokens, following the APIResponse schema.

object
success
required
boolean
data
required
object
customIdToken
required

Custom Firebase ID token for authenticated requests

string
customRefreshToken
required

Refresh token to obtain new session tokens

string
tosAccepted
required

Whether the user has accepted the terms of service

boolean
Example
{
  "success": true
}

400

Section titled “400”

Missing email or password

Media typeapplication/json

Standardized error response following the APIResponse schema.

object
success
required
boolean
message
required
string
Example
{
  "success": false,
  "message": "Bad request"
}

403

Section titled “403”

Invalid credentials or authentication failure

Media typeapplication/json

Standardized error response following the APIResponse schema.

object
success
required
boolean
message
required
string
Example
{
  "success": false,
  "message": "Bad request"
}