Download OpenAPI specification:Download
As a business network full stack platform, Kaleido provides a complete set of API for administrators, network operators and DApps developers.
The administrative endpoints provide full lifecycle operations around platform resources (consortia, environment, nodes, services, etc.) Each participating organization can use the API to fully automate the DevOps pipeline. Most of the resources are scoped to the organization that the logged in user is associated with. Some resources like consortia and environments support decentralized governance.
In a decentralized consortium, no single participant can delete the consortium until all but one participants have left the consortium.
In a decentrallized environment, no single participant can delete the environment until all but one participants have deleted their resources (nodes, services) inside the environment.
Kaleido is available in multiple regions. When a user resource like nodes or services is provisioned, a deployment region is determined based on a number of factors. This means the resource may be in a different region than the Kaleido console (the web UI). As such, when calling a Kaleido API, make sure to use the correct hostname for the region that the resource was provisioned in.
API endpoints for different regions are specified in Regional API Endpoints
The API is organized around the Platform Resources and Services. Platform resources include the foundation components to start a business network, such as consortia, environments, services, integration, etc. Kaleido has a large catalog of services, each providing their own developer-facing API. Each service API is displayed in their own category after the Platform Resources.
Kaleido API for platform resources are authenticated using the Bearer token in the
Authorization HTTP header. The token can either be the API Key created in the Kaleido user's account, or the JWT token
issued to the user's browser as a cookie after logging in. The JWT token is set to expire in one hour.
|Security Scheme Type||HTTP|
|HTTP Authorization Scheme||bearer|
Organization-specific administrative tokens that allow for resource CRUD operations via the Kaleido API. Similar to application credentials, API Keys are onetime-viewable strings and are not stored by the Kaleido backend. These endpoints do not support API Key generation and can only be used to retrieve or edit existing keys.
API Keys Retrieved
AWS US API base endpoint
AWS EU API base endpoint
AWS Sydney API base endpoint
AWS Seoul API base endpoint
Azure US API base endpoint
- "_id": "string",
- "_revision": "string",
- "created_at": "string",
- "updated_at": "string",
- "name": "string",
- "org_id": "string"