PingCAP · OpenAPI Overlay 1.0.0

API Evangelist enhancements for TiDB Cloud IAM API

4 actions 4 updates update extends openapi/pingcap-tidb-cloud-iam-v1beta1-openapi-original.json

Derived by API Evangelist Built from the contracts PingCAP publishes. PingCAP did not publish this file.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-slugx-apievangelist-sourcex-apievangelist-harvestedx-apievangelist-operationsx-apievangelist-base-urlx-apievangelist-authenticationx-apievangelist-authentication-artifact

Targets 1

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for TiDB Cloud IAM API
  version: 1.0.0
extends: openapi/pingcap-tidb-cloud-iam-v1beta1-openapi-original.json
x-generated: '2026-08-02'
x-method: generated
x-source: apis.yml + repo artifacts (no mutation of the harvested original)
actions:
- target: $.info
  update:
    x-apievangelist-provider: PingCAP
    x-apievangelist-slug: pingcap
    x-apievangelist-source: https://docs.pingcap.com/tidbcloud/api/v1beta1/iam/
    x-apievangelist-harvested: '2026-08-02'
    x-apievangelist-operations: 12
- target: $.info
  update:
    x-apievangelist-base-url: https://iam.tidbapi.com/v1beta1
- target: $.info
  update:
    x-apievangelist-authentication: HTTP Digest (RFC 7616) with a TiDB Cloud organization API key pair; not declared
      in the source spec (no securityDefinitions block)
    x-apievangelist-authentication-artifact: authentication/pingcap-authentication.yml
    x-apievangelist-rate-limit: 100 requests per minute per API key; X-Ratelimit-Limit-Minute / X-Ratelimit-Remaining-Minute
      / X-Ratelimit-Reset; 429 on exceed
    x-apievangelist-rate-limit-artifact: rate-limits/pingcap-rate-limits.yml
    x-apievangelist-error-envelope: google.rpc.Status {code, message, details[]} — not RFC 9457
    x-apievangelist-error-artifact: errors/pingcap-problem-types.yml
    x-apievangelist-conventions: conventions/pingcap-conventions.yml
    x-apievangelist-idempotency: none documented — retries of create operations are not deduplicated
- target: $.info
  update:
    x-apievangelist-gap: 12 of 12 operations in this document have no operationId; agents and code generators must
      fall back to method+path.

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/pingcap-tidb-cloud-iam-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.