> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/auth/register: PIN User Registration

> Register a new user on the Aria Compute PIN service. Requires a unique username, email, and a password of at least 6 characters.

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

<ParamField body="username" type="string" required>
  Desired username. Must be unique.
</ParamField>

<ParamField body="email" type="string" required>
  User's email address.
</ParamField>

<ParamField body="password" type="string" required>
  Password with a minimum length of 6 characters.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier of the newly created user.
</ResponseField>

## Example

```bash theme={null}
curl -X POST http://localhost:8001/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username":"alice","email":"alice@example.com","password":"secret123"}'
```

```json theme={null}
{
  "id": "usr_2vPqN9xL5wR8"
}
```

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

```json theme={null}
{
  "error": "conflict",
  "detail": "username already exists"
}
```


## Related topics

- [POST /v1/auth/login: PIN User Login](/api-reference/pin/auth/login.md)
- [GET /v1/auth/me: PIN Current User](/api-reference/pin/auth/me.md)
- [Register Account on Aria Compute ROUTER](/api-reference/router/auth/register.md)
- [Authenticate with PIN API Keys and Agent Tokens](/api-reference/pin/authentication.md)
- [Aria Compute PIN API: Post-Training & Evaluation](/api-reference/pin/introduction.md)