Refresh session tokens

POST

/v1/auth/refresh

curl --request POST \
  --url https://api.neuramancer.dev/v1/auth/refresh \
  --header 'Content-Type: application/json' \
  --data '{ "refreshToken": "example" }'

• Development environment
• Production environment

Exchanges a valid refresh token for new session tokens via Firebase. No middleware authentication required.

Request Body^required

Media typeapplication/json

object

refreshToken

required

Refresh token obtained from a previous login or refresh

string

Example^generated

{
  "refreshToken": "example"
}

Responses

200

Tokens refreshed successfully

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
}

403

Invalid or expired refresh token

Media typeapplication/json

Standardized error response following the APIResponse schema.

object

success

required

boolean

message

required

string

Example

{
  "success": false,
  "message": "Bad request"
}