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 Universe information API

The Universe information API from YugabyteDB — 11 operation(s) for universe information.

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

Tagged areas include Universe information. 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 12 operations across 11 paths, and defines 15 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.

12 operations 11 paths 15 schemas 1 DELETE11 GET

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 Universe information 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 12

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

Universe information 12
GET
/api/v1/customers/{cUUID}/cost
YugabyteDB Anywhere Get a Cost Estimate for All Universes
getUniverseCostForAll 1 param → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/costdeprecated
YugabyteDB Anywhere Get a Cost Estimate for a Universe - Deprecated
getUniverseCost 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/health_check
YugabyteDB Anywhere Return Results for the Last Health Check
healthCheckUniverse 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/leader
YugabyteDB Anywhere Get IP Address of a Universe's Master Leader
getMasterLeaderIP 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/live_queries
YugabyteDB Anywhere Get Live Queries for a Universe
getLiveQueries 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/master_infos
YugabyteDB Anywhere Get Master Information List
getMasterInfos 2 params → 200
DELETE
/api/v1/customers/{cUUID}/universes/{uniUUID}/slow_queries
YugabyteDB Anywhere Reset Slow Queries for a Universe
resetSlowQueries 3 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/slow_queries
YugabyteDB Anywhere Get Slow Queries for a Universe
getSlowQueries 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/status
YugabyteDB Anywhere Get a Universe's Status
universeStatus 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/trigger_health_check
YugabyteDB Anywhere Trigger a Universe Health Check
triggerHealthCheck 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/universe_resources
YugabyteDB Anywhere Get a Resource Usage Estimate for a Universe
getUniverseResources 2 params → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/{nodeName}/download_logsdeprecated
YugabyteDB Anywhere Download a Node's Logs - Deprecated
downloadNodeLogs 3 params → 200

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are UniverseResourceDetails_2 (11 properties), NodeData (11 properties), UniverseResourceDetails (11 properties), NodeData_2 (11 properties). Each schema is shown below with its type and property counts.

Metric
object
4 properties 4 required
UniverseResourceDetails
object
11 properties
Details
object
5 properties 4 required
MetricValue
object
2 properties 2 required
TriggerHealthCheckResult
object
The response type for triggering a health check. Contains the timestamp of when the health check was triggered.
1 property
MasterInfo
object
Information about master
5 properties 5 required
MetricLabel
object
2 properties 2 required
NodeData
object
11 properties 10 required
Metric_2
object
4 properties 4 required
UniverseResourceDetails_2
object
11 properties
Details_2
object
5 properties 4 required
MetricValue_2
object
2 properties 2 required
MasterInfo_2
object
Information about master
5 properties 5 required
MetricLabel_2
object
2 properties 2 required
NodeData_2
object
11 properties 10 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yugabytedb-universe-information-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