POST
/
api
/
v0
/
users
/
create subaccount
curl --request POST \
  --url https://console.vast.ai/api/v0/users/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "user@example.com",
  "username": "testuser123",
  "password": "securepass123",
  "host_only": true,
  "parent_id": "me",
  "ssh_key": "<string>",
  "captcha": "<string>"
}'
{
  "id": 12345,
  "username": "testuser",
  "email": "user@example.com",
  "api_key": "abc123def456"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
email
string
required

User's email address

Maximum length: 64
Example:

"user@example.com"

username
string
required

Desired username

Maximum length: 64
Example:

"testuser123"

password
string
required

Account password

Maximum length: 256
Example:

"securepass123"

host_only
boolean

If true, account is restricted to host functionality only

Example:

true

parent_id
string

Parent account ID for subaccounts. Use "me" for current user.

Example:

"me"

ssh_key
string

Optional SSH public key

Maximum length: 4096
captcha
string

Captcha token (required for non-subaccounts)

Maximum length: 8192

Response

Account created successfully

id
integer

User ID

username
string
email
string
api_key
string

API key for the new account