Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

YugabyteDB Runtime configuration API

The Runtime configuration API from YugabyteDB — 6 operation(s) for runtime configuration.

YugabyteDB Runtime configuration API is one of 73 APIs that YugabyteDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Runtime configuration. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 8 operations across 6 paths, and defines 12 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://cloud.yugabyte.com/api/public/v1.

8 operations 6 paths 12 schemas 1 DELETE6 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://cloud.yugabyte.com/api/public/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

YugabyteDB Runtime configuration API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — API key obtained from the YugabyteDB Aeon UI under User Profile API Keys. Pass the key as a Bearer token in the Authorization header.

Paths & Operations 8

Across 6 paths, the API surfaces 8 operations — 1 DELETE, 6 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Runtime configuration 8
GET
/api/v1/customers/{cUUID}/runtime_config/scopes
YugabyteDB Anywhere List Configuration Scopes
listScopes 2 params → 200
GET
/api/v1/customers/{cUUID}/runtime_config/{scope}
YugabyteDB Anywhere List Configuration Entries for a Scope
getConfig 4 params → 200
DELETE
/api/v1/customers/{cUUID}/runtime_config/{scope}/key/{key}
YugabyteDB Anywhere Delete a Configuration Key
deleteKey 4 params → 200
GET
/api/v1/customers/{cUUID}/runtime_config/{scope}/key/{key}
YugabyteDB Anywhere Get a Configuration Key
getConfigurationKey 4 params → 200
PUT
/api/v1/customers/{cUUID}/runtime_config/{scope}/key/{key}
YugabyteDB Anywhere Update a Configuration Key
setKey 4 params body → 200
GET
/api/v1/runtime_config/feature_flags
YugabyteDB Anywhere List All the Feature Flag Runtime Config Keys and Their Values.
listFeatureFlags → 200
GET
/api/v1/runtime_config/mutable_key_info
YugabyteDB Anywhere List Mutable Keys
listKeyInfo → 200
GET
/api/v1/runtime_config/mutable_keys
YugabyteDB Anywhere List Mutable Keys
listKeys → 200

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are ConfKeyInfo (6 properties), ConfKeyInfo_2 (6 properties), ScopedConfig (4 properties), ScopedConfig_2 (4 properties). Each schema is shown below with its type and property counts.

ConfDataTypeObject
object
1 property 1 required
RuntimeConfigData
object
Runtime configuration data
1 property
YBPSuccess
object
2 properties
ScopedConfig
object
Scoped configuration
4 properties
ConfigEntry
object
Configuration entry
3 properties
ConfKeyInfo
object
6 properties 6 required
ConfDataTypeObject_2
object
1 property 1 required
RuntimeConfigData_2
object
Runtime configuration data
1 property
YBPSuccess_2
object
2 properties
ScopedConfig_2
object
Scoped configuration
4 properties
ConfigEntry_2
object
Configuration entry
3 properties
ConfKeyInfo_2
object
6 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yugabytedb-runtime-configuration-api-openapi.yml Raw ↑

Other APIs YugabyteDB publishes across the network.

YugabyteDB Access Keys API
YugabyteDB Accounts API
YugabyteDB Alerts API
YugabyteDB AllowLists API
YugabyteDB Asynchronous Replication API
YugabyteDB Audit API
YugabyteDB Authentication API
YugabyteDB Availability Zones API
YugabyteDB Backup and Restore API
YugabyteDB Backups API
YugabyteDB Certificate Info API
YugabyteDB Cloud providers API