99Stack API

Automate your work

99Stack Cloud API allows you to manage instances and resources within 99Stack Cloud in a simple, programmatic way using conventional HTTP requests. The endpoints are intuitive, decentralized and powerful, allowing you to easily make calls to retrieve information or to execute actions at any time.

Requests

Any tool that is fluent in HTTP can communicate with 99Stack API, simply by requesting the correct URL. Requests should be made using the HTTPS protocol so that traffic is encrypted. The interface responds to different methods depending on the action required.

Method	Usage
GET	For simple retrieval of information about your account, resources, or environment, you should use the GET method. The information you request will be returned to you as a JSON object.
POST	To create a new object, your request should specify the POST method. The POST request includes all of the attributes necessary to create a new object. When you wish to create a new object, send a POST request to the target endpoint.
PATCH	Some resources support patial modification. In these cases, the PATCH method is available. Unlike PUT which generally requires a complete representation of a resource, a PATCH request is is a set of instructions on how to modify a resource updating only specific attributes.
DELETE	To destroy a resource and remove it from your account and environment, the DELETE method should be used. This will remove the specified object if it is found. If it is not found, the operation will return a response indicating that the object was not found.

Examples

A collection of quick examples for common actions can be found below. All examples are written in curl, for more examples in common programming languages see our Github page: github.com/99stack

Show regions: Returns a list over all available regions

curl -X GET \
  -H 'Content-Type: application/json' \
  "https://api.99stack.com/v1/region/list"

Show images: Returns a list over all available images, add /{region_id} to the end of url to see images available in a specific region.

curl -X GET \
  -H 'Content-Type: application/json' \
  "https://api.99stack.com/v1/image/list"

Show plans: Returns a list over all available plans, add /{region_id} to the end of url to see plans available in a specific region.

curl -X GET \
  -H 'Content-Type: application/json' \
  "https://api.99stack.com/v1/plan/list"

List servers: Returns all servers on authenticated account, this function requires an auth token YOUR_TOKEN. Visit: dash.99stack.com/auth/manage-api-tokens to create a new token.

curl -X GET \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  "https://api.99stack.com/v1/server/list"

Create API token: Generate a new API token

curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -d '{"name": "New API token"}'  \
  "https://api.99stack.com/v1/account/token_create"