UAPI: 71 | Notion

Using basic authentication is the easiest way to get started with our API. However, keep in mind that the API credentials that are generated for basic authentication give full access to your entire account, just as if you were logged into the control panel.

If you plan to distribute an application using our API, or allow more than one user access to the tool you're building, please use OAuth. This is the more secure alternative as it allows you to restrict what your application can do while authenticated to your account.

Invalidating tokens / api keys

When you generate a new api key in ComputeStacks, any previously generated tokens will be immediately invalidated.

OAuth2

Our OAuth2 endpoint supports the following grant types:

Authorization Code
Password
- Same API credentials used basic auth, not your normal login credentials.
Client Credentials
- Only has access to API methods with the public scope. No user data.
Refresh Token
- Only available via the Authorization Code grant type.

Scopes allow you to restrict what access your OAuth application has access to. When your users authenticate, they will be shown what access you're requesting, so please only request access to the scopes you will actually need.

Endpoint Type	URL
Token URL	/api/oauth/token
Authorization URL	/api/oauth/authorize

Available Scopes

public
images_read
images_write
dns_read
dns_write
order_read
order_write
profile_read
profile_write
register
project_read
project_write

Data Types

DateTime will be returned as a String
Decimal when referring to prices will be returned as a String.
Array<ContainerImage> means it returns the same result as the primary REST interface. For example, /api/projects/{project-id}/images would return an array of /api/container_images

Pagination

All collection requests will be paginated using the headers Per-Page and Total. To set these values in your request, pass the URL params page= and per_page=.

Versioning

You may optionally request a specific API version by modifying the Accept header with: application/json; api_version=71, where 71 is the version of the API.

If you omit this value, then the current version will be used.

Current version: 60