Instances API

A REST API for interacting with your instance resources.

Instances API

Every instance created in Zesty.io can be interacted with over https using the instance API (Application Programming Interface). When an instance is created it is assigned a ZUID (Zesty Universal IDentifier). Using this ZUID the instances API can be requested with the following URL pattern.

https://ZUID.api.zesty.io/v1/

The instance API is implemented as a REST (REpresentational State Transfer) architecture. It allows for CRUD (Create, Read, Update, Delete) operations on the requested instance.

Complete API Reference: https://instances-api.zesty.org

There can be many consumers of the Instances API. For example; the manager-ui consumes your instances API to provide it's functionality. Another common example is making instances API requests as part of a CI/CD (Continuous Intergration/Continuous Development) flow.

Access Permissions

Instance access is restricted by a roles & permissions system. Accessing an instance with the API requires making an authenticated request. Which is a request that includes an Authentication header which contains either a user session or an access token. Which one you use will depend upon your use case and needs.

Responses

All API responses are JSON (JavaScript Object Notation) format. Although JSON includes the JavaScript language name it is a common format consumable across many programming langauges. It acts as a standardized way to pass various data structures over http.

Tooling

Node SDK

The node-sdk is the primary tool for interacting with Zesty.io platform resources. It can be used to programatically manage an instance.