How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

YugabyteDB Universe Upgrades Management API

The Universe Upgrades Management API from YugabyteDB — 20 operation(s) for universe upgrades management.

This API exposes 20 operations across 20 paths, and defines 95 schemas. It is described by OpenAPI 3.2.0, at version v1.

Requests are made against a single base URL, /.

20 operations 20 paths 95 schemas 1 GET19 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://cloud.yugabyte.com/api/public/v1
Authentication
API Key
Contact
https://docs.yugabyte.com
Terms of Service
Resource Areas
1

Authentication & Security 1

YugabyteDB Universe Upgrades Management API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-AUTH-YW-API-TOKEN (apiKeyAuth).

  • apiKeyAuth — API token passed as header

Paths & Operations 20

Across 20 paths, the API surfaces 20 operations — 1 GET, 19 POST. Each is listed below with its method, path, parameters, and response codes.

Universe Upgrades Management 20
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/audit_log_config
Modify Audit Logging Configuration
modifyAuditLogging 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/certs
Upgrade Certs
upgradeCerts 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/db_version
Upgrade DB version
upgradeDBVersion 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/finalize
Finalize Upgrade
finalizeUpgrade 3 params body → 200
GET
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/finalize/info
Finalize Software Upgrade info
preFinalizeSoftwareUpgradeInfo 2 params → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/gflags
Upgrade GFlags
upgradeGFlags 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/k8s_immutable_ybc
Upgrade Kubernetes universe to toggle immutable YBC
kubernetesToggleImmutableYbc 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/kubernetes_overrides
Upgrade KubernetesOverrides
upgradeKubernetesOverrides 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/provision_nodes
Provision universe nodes
provisionUniverseNodes 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/proxy_config
Update Proxy Config
updateProxyConfig 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/reboot
Reboot universe
rebootUniverse 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/resize_node
Resize Node
resizeNode 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/restart
Restart Universe
restartUniverse 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/rollback
Rollback Upgrade
rollbackUpgrade 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/software
Upgrade Software
upgradeSoftware 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/software/precheck
Software Upgrade universe pre-check
softwareUpgradePreCheck 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/systemd
Upgrade Systemd
upgradeSystemd 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/thirdparty_software
Upgrade third-party software
upgradeThirdpartySoftware 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/tls
Upgrade TLS
upgradeTls 3 params body → 200
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/upgrade/vm
Upgrade VM Image
upgradeVMImage 3 params body → 200

Schemas 95

The contract defines 95 schemas that model the data the API accepts and returns. The most detailed are VMImageUpgradeParams (74 properties), ResizeNodeParams (71 properties), SoftwareUpgradeParams (71 properties), AuditLogConfigParams (70 properties). Each schema is shown below with its type and property counts.

YSQLAuditConfig
object
YSQL Audit Logging Configuration
11 properties 11 required
K8SNodeResourceSpec
object
2 properties 2 required
Region
object
Region within a given provider. Typically, this maps to a single cloud provider region.
12 properties 1 required
PlacementRegion
object
5 properties
PerProcessDetails
object
WARNING: This is a preview API that could change. User intent Properties that can be overriden on per-process basis.
2 properties
AZUpgradeStep
object
AZ upgrade step: order is list order; pauseAfterTserverUpgrade controls canary pause after this AZ
2 properties 1 required
CloudSpecificInfo
object
Node information reported by the cloud provider
18 properties
AuditLogConfigParams
object
70 properties 9 required
KubernetesToggleImmutableYbcParams
object
69 properties 8 required
RegionDetails
object
1 property
PlacementInfo
object
1 property 1 required
UniverseQueryLogsExporterConfig
object
Universe Logs Exporter Config
7 properties 2 required
AWSRegionCloudInfo
object
4 properties
AzureRegionCloudInfo
object
5 properties
ExtraDependencies
object
Extra dependencies
1 property
CloudVolumeEncryption
object
Volume encryption settings for AWS EBS volumes
2 properties
CanaryUpgradeConfig
object
Canary upgrade configuration
3 properties
ProvisionUniverseNodesParams
object
69 properties 7 required
ProxyConfigUpdateParams
object
68 properties 7 required
CommunicationPorts
object
Communication ports
15 properties
QueryLogConfig
object
Query Log Configuration
3 properties 1 required
AvailabilityZoneDetails
object
1 property
AZOverrides
object
WARNING: This is a preview API that could change. Availability zone level overrides
5 properties
YBPTask
object
2 properties
YSQLQueryLogConfig
object
YSQL Query Logging Configuration
10 properties 9 required
PrevYBSoftwareConfig
object
5 properties
KubernetesRegionInfo
object
22 properties 1 required
MetricsExportConfig
object
Metrics Export Configuration
5 properties 1 required
GFlagsUpgradeParams
object
70 properties 9 required
CertsRotateParams
object
70 properties 9 required
GCPRegionCloudInfo
object
2 properties
UpgradeTaskParams
object
68 properties 7 required
ImageBundleUpgradeInfo
object
2 properties 2 required
ResizeNodeParams
object
71 properties 10 required
SoftwareUpgradeParams
object
71 properties 9 required
PlacementCloud
object
4 properties
SpecificGFlags
object
GFlags for current cluster
4 properties
RegionCloudInfo
object
4 properties
SystemdUpgradeParams
object
68 properties 7 required
YCQLAuditConfig
object
YCQL Audit Logging Configuration
8 properties 8 required
ProxyConfig
object
The Proxy Settings for the Universe
3 properties
UserIntentOverrides
object
WARNING: This is a preview API that could change. User Intent overrides
2 properties
EarlyoomConfig
object
State for earlyoom service
6 properties
XClusterInfo
object
1 property
RestartTaskParams
object
68 properties 7 required
UniverseLogsExporterConfig
object
Universe Logs Exporter Config
2 properties 2 required
DeviceInfo
object
Device information
8 properties
AZCloudInfo
object
1 property
AdditionalServicesStateData
object
Additional services state
2 properties
FinalizeUpgradeInfoResponse
object
Finalize Upgrade Info Response
1 property
AvailabilityZone
object
Availability zone (AZ) for a region
9 properties 1 required
ImpactedXClusterConnectedUniverse
object
3 properties
Cluster
object
7 properties 2 required
FinalizeUpgradeParams
object
69 properties 8 required
UniverseMetricsExporterConfig
object
Metrics Exporter Configuration
8 properties 2 required
UserIntent
object
55 properties
PartitionInfo
object
WARNING: This is a preview API that could change. Information about Geo partition
5 properties
SoftwareUpgradeInfoResponse
object
Software Upgrade Info response
2 properties
TlsToggleParams
object
70 properties 9 required
KubernetesOverridesUpgradeParams
object
70 properties 9 required
PerProcessFlags
object
1 property 1 required
NodeDetails
object
Details of a cloud node
37 properties
RollMaxBatchSize
object
WARNING: This is a preview API that could change.Information about suggested number of servers to roll at a time
2 properties
ThirdpartySoftwareUpgradeParams
object
69 properties 8 required
VMImageUpgradeParams
object
74 properties 9 required
AuditLogConfig
object
Audit Log Configuration
4 properties 1 required
PlacementAZ
object
9 properties
EncryptionAtRestConfig
object
Encryption at rest configuration
4 properties
SoftwareUpgradeInfoRequest
object
Software upgrade info request
1 property 1 required
Users
object
A user associated with a customer
12 properties 3 required
RollbackUpgradeParams
object
69 properties 7 required
PlacementRegion_2
object
4 properties
Region_2
object
Region within a given provider. Typically, this maps to a single cloud provider region.
12 properties 1 required
CloudSpecificInfo_2
object
Node information reported by the cloud provider
14 properties
PlacementInfo_2
object
1 property 1 required
ExtraDependencies_2
object
Extra dependencies
1 property
CommunicationPorts_2
object
Communication ports
11 properties
YBPTask_2
object
2 properties
ResizeNodeParams_2
object
42 properties 6 required
GFlagsUpgradeParams_2
object
43 properties 7 required
CertsRotateParams_2
object
43 properties 10 required
UpgradeTaskParams_2
object
41 properties 5 required
SoftwareUpgradeParams_2
object
42 properties 6 required
PlacementCloud_2
object
4 properties
SystemdUpgradeParams_2
object
41 properties 5 required
DeviceInfo_2
object
Device information
7 properties
AvailabilityZone_2
object
Availability zone (AZ) for a region
8 properties 1 required
Cluster_2
object
6 properties 2 required
UserIntent_2
object
32 properties
TlsToggleParams_2
object
43 properties 11 required
NodeDetails_2
object
Details of a cloud node
28 properties
VMImageUpgradeParams_2
object
44 properties 8 required
ThirdpartySoftwareUpgradeParams_2
object
42 properties 6 required
PlacementAZ_2
object
7 properties
EncryptionAtRestConfig_2
object
Encryption at rest configuration
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yugabytedb-universe-upgrades-management-api-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of YugabyteDB Universe Upgrades Management API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.