POST /v1/auth/register: PIN User Registration

Create a new PIN user account with a username, email, and password. Usernames must be unique across the service. After registration, use /v1/auth/login to obtain a session token.

Endpoint

POST /v1/auth/register Authentication: None

Request body

string

required

Desired username. Must be unique.

string

required

User’s email address.

string

required

Password with a minimum length of 6 characters.

Response

string

Unique identifier of the newly created user.

Example

curl -X POST http://localhost:8001/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username":"alice","email":"[email protected]","password":"secret123"}'

{
  "id": "usr_2vPqN9xL5wR8"
}

If the username is already taken, the endpoint returns 409 Conflict:

{
  "error": "conflict",
  "detail": "username already exists"
}

PIN API

ROUTER API

AGENT API

POST /v1/auth/register: PIN User Registration

Endpoint

Request body

Response

Example

​Endpoint

​Request body

​Response

​Example

Endpoint

Request body

Response

Example