From 2d8eb4bca12683629874e3ca1ae833632c202f1e Mon Sep 17 00:00:00 2001 From: vbotbuildovich <62446873+vbotbuildovich@users.noreply.github.com> Date: Wed, 8 Jul 2026 16:32:13 +0000 Subject: [PATCH 1/2] auto-docs: Update Cloud API spec --- cloud-controlplane/cloud-controlplane.yaml | 189 ++++++++++++++++++++- cloud-dataplane/cloud-dataplane.yaml | 2 +- 2 files changed, 181 insertions(+), 10 deletions(-) diff --git a/cloud-controlplane/cloud-controlplane.yaml b/cloud-controlplane/cloud-controlplane.yaml index 3dcb2b9..14a54cd 100644 --- a/cloud-controlplane/cloud-controlplane.yaml +++ b/cloud-controlplane/cloud-controlplane.yaml @@ -413,6 +413,23 @@ components: - aks_service_cidr title: CIDR type: object + CidrPort: + description: CidrPort represents a CIDR block and port or port range for network access control. + properties: + cidr: + description: CIDR notation, e.g. "10.5.0.0/16". Must be a valid IPv4 CIDR. + type: string + port_end: + description: |- + Optional end of the TCP/UDP port range, 0-65535. When 0 (default), only port_start is used. + When non-zero, must be >= port_start. + format: int32 + type: integer + port_start: + description: Start of the TCP/UDP port range, 1-65535. + format: int32 + type: integer + type: object CloudProvider: description: Cloud provider where resources are created. enum: @@ -690,7 +707,9 @@ components: sasl: $ref: '#/components/schemas/SASLSpec' seed_brokers: - description: Kafka API Seed Brokers (also known as Bootstrap servers). + description: |- + Kafka API Seed Brokers (also known as Bootstrap servers). + Deprecated: use connections[].endpoint instead. items: type: string type: array @@ -715,7 +734,9 @@ components: sasl: $ref: '#/components/schemas/SASLSpec' url: - description: Schema Registry URL. + description: |- + Schema Registry URL. + Deprecated: use connections[].endpoint instead. type: string type: object Cluster.State: @@ -800,6 +821,8 @@ components: items: type: string type: array + redpanda_connect: + $ref: '#/components/schemas/RedpandaConnect' redpanda_node_count: description: redpanda_node_count defines the starting node count for the cluster. format: int32 @@ -945,6 +968,8 @@ components: items: type: string type: array + redpanda_connect: + $ref: '#/components/schemas/RedpandaConnect' redpanda_node_count: format: int32 type: integer @@ -1511,6 +1536,9 @@ components: DeleteNetworkResponse: description: DeleteNetworkResponse is the response of DeleteNetwork. type: object + DeleteOrganizationResponse: + description: DeleteOrganizationResponse is the response of the DeleteOrganization rpc. + type: object DeleteResourceGroupResponse: description: DeleteResourceGroupResponse is the response of DeleteResourceGroup. type: object @@ -1563,16 +1591,20 @@ components: description: The endpoints of Redpanda HTTP Proxy or Schema Registry. properties: mtls: - description: URL of the seed broker for mTLS. If mTLS is not enabled, the field is empty. + description: |- + URL of the seed broker for mTLS. If mTLS is not enabled, the field is empty. + Deprecated: use connections[].endpoint instead. type: string private_link_mtls: - description: URL of the seed broker for private link with mTLS. If private link with mTLS is not enabled, the field is empty. + description: URL of the endpoint for private link with mTLS. If private link with mTLS is not enabled, the field is empty. type: string private_link_sasl: - description: URL of the seed broker for private link with SASL. If private link with SASL is not enabled, the field is empty. + description: URL of the endpoint for private link with SASL. If private link with SASL is not enabled, the field is empty. type: string sasl: - description: URL of the seed broker for SASL. If SASL is not enabled, the field is empty. + description: |- + URL of the seed broker for SASL. If SASL is not enabled, the field is empty. + Deprecated: use connections[].endpoint instead. type: string type: object ErrorInfo: @@ -2013,7 +2045,7 @@ components: sasl: $ref: '#/components/schemas/SASLSpec' url: - description: HTTP Proxy URL of cluster. + description: 'HTTP Proxy URL of cluster. Deprecated: use connections[].endpoint instead.' example: https://pandaproxy-aa0000l0.cjb69h1c4vs42pca89s0.fmc.prd.cloud.redpanda.com:9092 readOnly: true type: string @@ -3086,6 +3118,67 @@ components: username: type: string type: object + Quota: + description: Platform-enforced upper bounds applied to the Serverless cluster. + properties: + acls: + format: int64 + readOnly: true + type: string + ai_agents: + format: int64 + readOnly: true + type: string + bytes_from_client: + $ref: '#/components/schemas/Rate' + bytes_to_client: + $ref: '#/components/schemas/Rate' + client_connections: + format: int64 + readOnly: true + type: string + connect_pipelines: + format: int64 + readOnly: true + type: string + consumer_groups: + format: int64 + readOnly: true + type: string + mcp_servers: + format: int64 + readOnly: true + type: string + partitions: + format: int64 + readOnly: true + type: string + passwords_per_user: + format: int64 + readOnly: true + type: string + producer_ids: + format: int64 + readOnly: true + type: string + sr_schemas: + format: int64 + readOnly: true + type: string + sr_subjects: + format: int64 + readOnly: true + type: string + topics: + format: int64 + readOnly: true + type: string + users: + format: int64 + readOnly: true + type: string + readOnly: true + type: object QuotaFailure: description: |- Describes how a quota check failed. @@ -3205,9 +3298,29 @@ components: developer project id>". type: string type: object + Rate: + description: Rate is a maximum number of units per period, along with a burst of units. + properties: + burst: + format: int32 + readOnly: true + type: integer + period: + readOnly: true + type: string + rate: + format: int32 + readOnly: true + type: integer + type: object RedpandaConnect: description: Cluster's Redpanda Connect properties. properties: + allowed_destination_cidr_ports: + description: Custom outbound destinations allowed for Connect pipelines. Maximum 16 entries. + items: + $ref: '#/components/schemas/CidrPort' + type: array version: description: Version of the Redpanda Connect engine running on the Cluster. readOnly: true @@ -3493,7 +3606,9 @@ components: description: Seed brokers of Redpanda Kafka API. properties: mtls: - description: URL of the seed broker for mTLS. If mTLS is not enabled, the field is empty. + description: |- + URL of the seed broker for mTLS. If mTLS is not enabled, the field is empty. + Deprecated: use connections[].endpoint instead. type: string private_link_mtls: description: URL of the seed broker for private link with mTLS. If private link with mTLS is not enabled, the field is empty. @@ -3502,7 +3617,9 @@ components: description: URL of the seed broker for private link with SASL. If private link with SASL is not enabled, the field is empty. type: string sasl: - description: URL of the seed broker for SASL. If SASL is not enabled, the field is empty. + description: |- + URL of the seed broker for SASL. If SASL is not enabled, the field is empty. + Deprecated: use connections[].endpoint instead. type: string type: object ServerlessCluster: @@ -3541,6 +3658,8 @@ components: type: string prometheus: $ref: '#/components/schemas/ServerlessCluster.Prometheus' + quota: + $ref: '#/components/schemas/Quota' resource_group_id: description: Resource group ID of the cluster. example: a0b40af9-0250-48ca-9417-783ed127ce42 @@ -4874,6 +4993,12 @@ components: $ref: '#/components/schemas/GCPServiceAccount' redpanda_operator_service_account: $ref: '#/components/schemas/GCPServiceAccount' + rpsql_api_service_account: + $ref: '#/components/schemas/GCPServiceAccount' + rpsql_cloud_storage_bucket: + $ref: '#/components/schemas/CustomerManagedGoogleCloudStorageBucket' + rpsql_service_account: + $ref: '#/components/schemas/GCPServiceAccount' subnet: $ref: '#/components/schemas/GCP.Subnet' tiered_storage_bucket: @@ -5333,6 +5458,7 @@ paths: desired_redpanda_version: "" http_proxy: all_urls: null + connections: [] mtls: ca_certificates_pem: [] enabled: false @@ -5342,6 +5468,7 @@ paths: id: cjd3r21c4vs870t0ku30 kafka_api: all_seed_brokers: null + connections: [] mtls: null sasl: null seed_brokers: @@ -5364,6 +5491,7 @@ paths: sandbox: null schema_registry: all_urls: null + connections: [] mtls: null sasl: null url: schema-registry-aa0000l0.cjd3r21c4vs870t0ku30.fmc.prd.cloud.redpanda.com:9092 @@ -5559,6 +5687,8 @@ paths: items: type: string type: array + redpanda_connect: + $ref: '#/components/schemas/RedpandaConnect' redpanda_node_count: format: int32 type: integer @@ -5683,6 +5813,7 @@ paths: desired_redpanda_version: "" http_proxy: all_urls: null + connections: [] mtls: ca_certificates_pem: [] enabled: false @@ -5692,6 +5823,7 @@ paths: id: cjd3r21c4vs870t0ku30 kafka_api: all_seed_brokers: null + connections: [] mtls: null sasl: null seed_brokers: @@ -5714,6 +5846,7 @@ paths: sandbox: null schema_registry: all_urls: null + connections: [] mtls: null sasl: null url: schema-registry-aa0000l0.cjd3r21c4vs870t0ku30.fmc.prd.cloud.redpanda.com:9092 @@ -6550,6 +6683,7 @@ paths: desired_redpanda_version: "" http_proxy: all_urls: null + connections: [] mtls: ca_certificates_pem: [] enabled: false @@ -6559,6 +6693,7 @@ paths: id: cjb69h1c4vs42pca89s0 kafka_api: all_seed_brokers: null + connections: [] mtls: null sasl: null seed_brokers: @@ -6581,6 +6716,7 @@ paths: sandbox: null schema_registry: all_urls: null + connections: [] mtls: null sasl: null url: schema-registry-aa0000l0.cjb69h1c4vs42pca89s0.fmc.prd.cloud.redpanda.com:9092 @@ -6683,6 +6819,7 @@ paths: desired_redpanda_version: "" http_proxy: all_urls: null + connections: [] mtls: ca_certificates_pem: [] enabled: false @@ -6692,6 +6829,7 @@ paths: id: cjb69h1c4vs42pca89s0 kafka_api: all_seed_brokers: null + connections: [] mtls: null sasl: null seed_brokers: @@ -6714,6 +6852,7 @@ paths: sandbox: null schema_registry: all_urls: null + connections: [] mtls: null sasl: null url: schema-registry-aa0000l0.cjb69h1c4vs42pca89s0.fmc.prd.cloud.redpanda.com:9092 @@ -6791,6 +6930,36 @@ paths: tags: - Organization /v1/organizations/current: + delete: + description: Delete the current organization. Only serverless organizations with no clusters and no outstanding usage can be deleted. + operationId: OrganizationService_DeleteOrganization + responses: + "204": + content: + application/json: + schema: {} + description: No Content + "400": + content: + application/json: + schema: + $ref: '#/components/schemas/rpc.Status' + description: Bad Request. The organization is not eligible for deletion. + "500": + content: + application/json: + schema: + $ref: '#/components/schemas/rpc.Status' + description: Internal Server Error. Please reach out to support. + default: + content: + application/json: + schema: + $ref: '#/components/schemas/rpc.Status' + description: An unexpected error response. + summary: Delete organization + tags: + - Organization get: description: Get information about the current organization. operationId: OrganizationService_GetCurrentOrganization @@ -7635,6 +7804,7 @@ paths: prometheus: private_url: "" url: https://d1d9risv0c3i7qbbeoc0.metrics.us-east-1.mpx.prd.cloud.redpanda.com/public_metrics + quota: null resource_group_id: 6c09e47b-f426-4ec7-a7b4-8048caf8ae47 schema_registry: private_url: "" @@ -7791,6 +7961,7 @@ paths: prometheus: private_url: "" url: https://d1d9risv0c3i7qbbeoc0.metrics.us-east-1.mpx.prd.cloud.redpanda.com/public_metrics + quota: null resource_group_id: 6c09e47b-f426-4ec7-a7b4-8048caf8ae47 schema_registry: private_url: "" diff --git a/cloud-dataplane/cloud-dataplane.yaml b/cloud-dataplane/cloud-dataplane.yaml index e0b311b..3992089 100644 --- a/cloud-dataplane/cloud-dataplane.yaml +++ b/cloud-dataplane/cloud-dataplane.yaml @@ -7856,7 +7856,7 @@ paths: schema: $ref: '#/components/schemas/TransformMetadata' description: Created - summary: Deploy transform + summary: Deploy Transform tags: - Wasm Transforms /v1/transforms/{name}: From 118cc7167a77715b8ddac1f0730f8a0378aacb46 Mon Sep 17 00:00:00 2001 From: Kat Batuigas <36839689+kbatuigas@users.noreply.github.com> Date: Wed, 8 Jul 2026 09:41:18 -0700 Subject: [PATCH 2/2] Apply suggestion from @kbatuigas --- cloud-dataplane/cloud-dataplane.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cloud-dataplane/cloud-dataplane.yaml b/cloud-dataplane/cloud-dataplane.yaml index 3992089..e0b311b 100644 --- a/cloud-dataplane/cloud-dataplane.yaml +++ b/cloud-dataplane/cloud-dataplane.yaml @@ -7856,7 +7856,7 @@ paths: schema: $ref: '#/components/schemas/TransformMetadata' description: Created - summary: Deploy Transform + summary: Deploy transform tags: - Wasm Transforms /v1/transforms/{name}: