Skip to content

Users

Account Scope Required, please include X-Auth-Account header with your Account ID. These endpoints are not available via OAuth. Creating, updating, and deleting users requires an admin role on the account, and the account must be a reseller.

List Users

List all users associated with your account.

GET /api/users

Returned Params
  • users: Array
    • id: String
    • fname: String
    • lname: String
    • email: String
    • account_brand_id: Integer
    • locale: String
    • created_at: DateTime
    • updated_at: DateTime

View User

View a user.

GET /api/users/:id

Returned Params
  • user: Object
    • id: String
    • fname: String
    • lname: String
    • email: String
    • account_brand_id: Integer
    • locale: String
    • created_at: DateTime
    • updated_at: DateTime

Create a User

POST /api/users

This will create a user (and a new sub-account) under the current account. Requires a reseller account; creating from a SuperSpace admin account returns 422.

Params
  • user: Object
    • fname: String (required)
    • lname: String (required)
    • email: String (required)
    • company_name: String | This will be the account name.
    • locale: String | en or nl
    • billing_term: String | monthly or annual
Returned Params
  • user: Object
    • id: String
    • fname: String
    • lname: String
    • email: String
    • created_at: DateTime
    • updated_at: DateTime
    • password: String | Returned only on creation.
    • account_id: String
    • api_token: String | Returned only on creation.

password and api_token are returned only in this create response — store them immediately. Use the returned API credentials to authenticate as that user going forward.

Update / Delete a User

PATCH /api/users/:id and DELETE /api/users/:id are not permitted and return 401.