TiDB Cloud API Overview



The TiDB Cloud API is a REST interface that provides you with programmatic access to manage administrative objects within TiDB Cloud. Through this API, you can automatically and efficiently manage resources such as projects, clusters, backups, restores, imports, billings, and resources in the Data Service.

The API has the following features:

  • JSON entities. All entities are expressed in JSON.
  • HTTPS-only. You can only access the API via HTTPS, ensuring all the data sent over the network is encrypted with TLS.
  • Key-based access and digest authentication. Before you access the TiDB Cloud API, you must generate an API key. For more information, see API Key Management. All requests are authenticated through HTTP Digest Authentication, ensuring the API key is never sent over the network.

The TiDB Cloud API is available in the following versions:

  • v1beta2: manage TiDB Cloud Essential instances (running TiDB version CLOUD.202603.x or later) and TiDB Cloud Premium instances.
  • v1beta1: manage TiDB Cloud Essential instances (running TiDB v8.5.3 or earlier), TiDB Cloud Starter instances, and TiDB Cloud Dedicated clusters, as well as billing, Data Service, and IAM resources.
  • v1beta: manage projects, clusters, backups, imports, and restores for TiDB Cloud Dedicated clusters.

Was this page helpful?