Create a user

POST

/v1/users

Creates a gateway user. Pass X-User-ID: <id> on chat requests to
attribute token usage and live-priced costs to this user.

Request

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Created user

Headers

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/users' \
--header 'Content-Type: application/json' \
--data '{
    "name": "alice"
}'

Response Example

201 - Example 1

{
    "id": "usr_1717000000000000000",
    "name": "alice",
    "created_at": "2019-08-24T14:15:22.123Z",
    "usage": [
        {
            "session_id": "string",
            "model": "claude-sonnet-4-6",
            "provider": "bedrock",
            "tokens": 0,
            "prompt_tokens": 0,
            "completion_tokens": 0,
            "cost_usd": 0.000425,
            "timestamp": "2019-08-24T14:15:22.123Z"
        }
    ]
}

Modified at 2026-10-20 19:28:20

List all users

Get a user