99Stack API

Automate your work with 99Stack API. View documentation for all versions.

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"

v-1.1: (stable)

Current stable API documentation for version 1.1. Document is divided into multiple modules for easier editing and overview. It's open source and any feedback is welcome.

View v-1.1
Contribute

OpenAPI v3.0 yaml specifications for 99Stack API is available as open-source on Github, report issues or participate in the development of 99Stack API there.

View on Github
API Endpoints

Multiple endpoints are available depending on your needs. All endpoints runs on different servers but communicate with the same cluster of database servers spread around the globe.

  • Global: https://api.99stack.com/v1
Privacy friendly and secure. API function calls goes via our global servers without using middlemen.

  • Ireland (Europe):
    https://api.eu-west.aws.99stack.com/v1
  • Germany (Europe):
    https://api.eu-central.aws.99stack.com/v1
  • Virginia (USA):
    https://api.us-east.aws.99stack.com/v1
  • Oregon (USA):
    https://api.us-west.aws.99stack.com/v1
  • India (Asia):
    https://api.as-south.aws.99stack.com/v1
  • South Korea (Asia):
    https://api.as-east.aws.99stack.com/v1
  • Sydney (Australia):
    https://api.au-east.aws.99stack.com/v1
Privacy friendly and secure. API function calls goes directly to our regional servers without using middlemen.

  • Cloudflare: https://cf-api.99stack.com/v1
Using Cloudflare CDN with strict encryption, this option lacks privacy, but is great when you need to gather large amounts of public information such as region, plan and image lists.