UpCloud

Account Management

Manage your UpCloud accounts and subaccounts. The main account can list all associated accounts, get detailed information about each account, modify account settings, and create or delete subaccounts.

GET/1.3/account/list

Get account list

Returns a list of all accounts associated with the main account. Account listing is only available to the main account.

Request

GET
/1.3/account/list
curl -X GET https://api.upcloud.com/1.3/account/list \
  -u your_username:your_password
GET/1.3/account/details/{username}

Get account details

Returns detailed information about a specific account.

Request

GET
/1.3/account/details/{username}
curl -X GET https://api.upcloud.com/1.3/account/details/my_sub_account \
  -u your_username:your_password
PUT/1.3/account/details/{username}

Modify account details

Modifies account details for a specific account.

Request attributes

  • Name
    first_name
    Type
    string
    Description

    First name (1-50 characters).

  • Name
    last_name
    Type
    string
    Description

    Last name (1-50 characters).

  • Name
    email
    Type
    string
    Description

    Valid email address.

Request

PUT
/1.3/account/details/{username}
curl -X PUT https://api.upcloud.com/1.3/account/details/my_sub_account \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{"account": {"first_name": "John"}}'
POST/1.3/account/sub

Add subaccount

Creates a new subaccount under the main account.

Required fields

  • Name
    username
    Type
    string
    Description

    Username (4-64 characters).

  • Name
    email
    Type
    string
    Description

    Valid email address.

Request

POST
/1.3/account/sub
curl -X POST https://api.upcloud.com/1.3/account/sub \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{"sub_account": {"username": "newuser", "email": "[email protected]"}}'
DELETE/1.3/account/sub/{username}

Delete subaccount

Deletes a subaccount.

Request

DELETE
/1.3/account/sub/{username}
curl -X DELETE https://api.upcloud.com/1.3/account/sub/my_sub_account \
  -u your_username:your_password