Skip to main content

Changelog

This page lists the changes to the endpoints in this section. The newest changes are at the top. Read this page when you update an agent, a skill, or a script that calls these endpoints.

Each entry has a date. An entry can have these parts:

PartMeaning
AddedNew endpoints or new optional fields. Existing calls continue to work.
ChangedChanges to behavior, fields, or limits.
DeprecatedThe endpoint or field continues to work, but it will be removed. The entry tells you what to use instead.
RemovedThe endpoint or field is not available.

A change that can cause existing calls to fail has the mark Breaking. The entry gives the steps to migrate.

2026-11-12​

First release. An API token can call 79 endpoints in 14 categories:

CategoryEndpoints
Query API5
Query results3
Query history5
Warehouses5
Organization and metrics2
Catalog7
SQL tasks2
Account3
Organization2
Billing4
Support tickets7
Task flows9
Data sources12
Data integration tasks13

The Endpoint Index lists each endpoint with its method, path, type, and access level.

These conventions apply to all endpoints. This page will record each change to them:

  • Send the token in the X-DATABENDCLOUD-TOKEN header. The server rejects a request that also has an Authorization header or cookies. Refer to Authentication.
  • There are two request styles. v1 endpoints have the organization ID in the path. v2 endpoints use POST and have orgSlug in the JSON body. Refer to Request Conventions.
  • The token IP allowlist applies to all endpoints.
  • Endpoints that are not in this section return HTTP 403.

These console functions are not open to API tokens in this release: audit log search, ticket attachments, and task flow changes. Refer to Endpoints That API Tokens Cannot Call.

Try Databend Cloud for FREE

Multimodal, object-storage-native warehouse for BI, vectors, search, and geo.

Snowflake-compatible SQL with automatic scaling.

Sign up and get $200 in credits.

Try it today