Skip to main content
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": "[email protected]",
  "username": "testuser123",
  "password": "securepass123",
  "host_only": true,
  "parent_id": "me",
  "ssh_key": "<string>",
  "captcha": "<string>"
}
'
{
  "id": 12345,
  "username": "testuser",
  "email": "[email protected]",
  "key_id": 67890
}

Authorizations

​
Authorization
string
header
required

API key must be provided in the Authorization header

Body

application/json
​
email
string
required

User's email address

Maximum string length: 64
Example:

"[email protected]"

​
username
string
required

Desired username

Maximum string length: 64
Example:

"testuser123"

​
password
string
required

Account password

Maximum string 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 string length: 4096
​
captcha
string

Captcha token (required for non-subaccounts)

Maximum string length: 8192

Response

Account created successfully

​
id
integer

User ID

​
username
string
​
email
string
​
key_id
integer

API key for the new account