Skip to content

auto-docs: Update Cloud API spec #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Conversation

vbotbuildovich
Copy link

@vbotbuildovich vbotbuildovich commented Jul 30, 2025

This PR updates the OpenAPI spec file for the Cloud API.
Triggered by commit: 56e7dc4ea7e5d68a8d549908341ee39def366ee6

Copy link

github-actions bot commented Jul 30, 2025

🚨 Breaking API change detected:

Added (1)

  • PATCH /v1/organizations/current

Modified (13)

  • DELETE /v1/clusters/{id}
    • Response modified: 202
      • Content type modified: application/json
        • Property modified: operation
          • Property modified: response
  • DELETE /v1/networks/{id}
    • Response modified: 202
      • Content type modified: application/json
        • Property modified: operation
          • Property modified: response
  • DELETE /v1/serverless/clusters/{id}
    • Response modified: 202
      • Content type modified: application/json
        • Property modified: operation
          • Property modified: response
  • GET /v1/clusters
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: clusters
          • [Breaking] Property removed: internet_gateways
            • Removing a resource is always breaking unless it was deprecated before [Breaking]
          • Property added: nat_gateways
  • GET /v1/clusters/{id}
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: cluster
          • [Breaking] Property removed: internet_gateways
            • Removing a resource is always breaking unless it was deprecated before [Breaking]
          • Property added: nat_gateways
  • GET /v1/operations
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: operations
          • Property modified: response
  • GET /v1/operations/{id}
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: operation
          • Property modified: response
  • GET /v1/organizations/available
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: organizations
          • Property added: mfa_enforced
  • GET /v1/organizations/current
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: organization
          • Property added: mfa_enforced
  • POST /v1/clusters
    • Response modified: 202
      • Content type modified: application/json
        • Property modified: operation
          • Property modified: response
  • POST /v1/networks
    • Response modified: 202
      • Content type modified: application/json
        • Property modified: operation
          • Property modified: response
  • POST /v1/serverless/clusters
    • Response modified: 202
      • Content type modified: application/json
        • Property modified: operation
          • Property modified: response
  • POST /v1/service-accounts
    • Content type modified: application/json
      • Property modified: service_account
        • Property added: role_bindings

Preview documentation

Powered by Bump.sh

Copy link

github-actions bot commented Jul 30, 2025

🚨 Breaking API change detected:

Added (12)

  • DELETE /v1/roles/{role_name}
  • GET /v1/quotas
  • GET /v1/roles
  • GET /v1/roles/{role_name}
  • GET /v1/roles/{role_name}/members
  • POST /v1/quotas
  • POST /v1/quotas:batchDelete
  • POST /v1/quotas:batchSet
  • POST /v1/quotas:delete
  • POST /v1/redpanda-connect/pipelines:lint-config
  • POST /v1/roles
  • PUT /v1/roles/{role_name}

Modified (63)

  • DELETE /v1/acls
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: matching_acls
          • Property modified: error
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/cloud-storage/mount-tasks/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/kafka-connect/clusters/{cluster_name}/secrets/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/redpanda-connect/pipelines/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/secrets/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/topics/{topic_name}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/transforms/{name}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • DELETE /v1/users/{name}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/acls
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/cloud-storage/mount-tasks
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/cloud-storage/mount-tasks/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/cloud-storage/topics/mountable
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters/{cluster_name}
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: cluster
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: address, info, name, plugins
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters/{cluster_name}/connectors
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: connector
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config, name, tasks, type
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/config
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • [Breaking] Response removed: 200
      • Removing a resource is always breaking unless it was deprecated before [Breaking]
  • GET /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/status
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: status
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: connector, errors, holistic_state, name, tasks, type
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/topics
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters/{cluster_name}/secrets
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/kafka-connect/clusters/{cluster_name}/secrets/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/redpanda-connect/config-schema
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/redpanda-connect/pipelines
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/redpanda-connect/pipelines-by-secrets
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/redpanda-connect/pipelines-for-secret
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/redpanda-connect/pipelines/{id}
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: pipeline
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config_yaml, description, display_name, id, resources, state, status, tags, url
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/secret-scopes
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/secrets
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/secrets/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/topics
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/topics/{topic_name}/configurations
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/transforms
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/transforms/{name}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • GET /v1/users
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PATCH /v1/topics-partitions
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PATCH /v1/topics/{topic_name}/configurations
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PATCH /v1/topics/{topic_name}/partitions
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/acls
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/cloud-storage/mount-tasks/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/cloud-storage/topics/mount
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/cloud-storage/topics/unmount
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/kafka-connect/clusters/{cluster_name}/connectors
    • Response modified: 201
      • Content type modified: application/json
        • [Breaking] Property removed: connector
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config, name, tasks, type
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/restart
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/kafka-connect/clusters/{cluster_name}/secrets
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/redpanda-connect/pipelines
    • Response modified: 201
      • Content type modified: application/json
        • [Breaking] Property removed: pipeline
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config_yaml, description, display_name, id, resources, state, status, tags, url
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/secrets
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/topics
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • POST /v1/users
    • Response modified: 400
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/config
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: connector
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config, name, tasks, type
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/pause
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/resume
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/stop
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/topics/reset
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/kafka-connect/clusters/{cluster_name}/secrets/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/redpanda-connect/pipelines/{id}
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: pipeline
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config_yaml, description, display_name, id, resources, state, status, tags, url
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/redpanda-connect/pipelines/{id}/start
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: pipeline
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config_yaml, description, display_name, id, resources, state, status, tags, url
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/redpanda-connect/pipelines/{id}/stop
    • Response modified: 200
      • Content type modified: application/json
        • [Breaking] Property removed: pipeline
          • Removing a resource is always breaking unless it was deprecated before [Breaking]
        • Properties added: config_yaml, description, display_name, id, resources, state, status, tags, url
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/secrets/{id}
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/topics-partitions
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/topics/{topic_name}/configurations
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/topics/{topic_name}/partitions
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 404
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
  • PUT /v1/users/{user.name}
    • Response modified: 400
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 401
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: 500
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure
    • Response modified: default
      • Content type modified: application/json
        • Property modified: details
          • Alternatives modified: BadRequest, QuotaFailure

Preview documentation

Powered by Bump.sh

@vbotbuildovich vbotbuildovich force-pushed the update-branch-api branch 5 times, most recently from 5523c74 to 96105da Compare August 8, 2025 20:27
Copy link

coderabbitai bot commented Aug 18, 2025

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

📝 Walkthrough

Walkthrough

  • Cluster schema: Added nat_gateways (array[string], readOnly); removed internet_gateways. Examples updated accordingly.
  • Organization schema: Added mfa_enforced (boolean).
  • New types: OrganizationUpdate (mfa_enforced), UpdateOrganizationResponse (organization: Organization).
  • New endpoint: PATCH /v1/organizations/current accepts OrganizationUpdate; returns ListAvailableOrganizationsResponse; tagged under Organization. Various summary/title capitalization updates across endpoints.
  • Doc links updated in several descriptions.
  • Serverless endpoint summaries standardized.
  • cloud-regions.md: Replaced static tables with collapsible sections per provider; added ARIA labels, sr-only descriptions, and bullet lists for throughput tiers. No data changes.

Sequence Diagram(s)

sequenceDiagram
  participant Client
  participant API as Control Plane API
  participant OrgSvc as Organization Service
  participant DB

  Client->>API: PATCH /v1/organizations/current (OrganizationUpdate)
  API->>OrgSvc: Validate and forward update (mfa_enforced)
  OrgSvc->>DB: Update organization settings
  DB-->>OrgSvc: Persisted organization
  OrgSvc-->>API: Updated Organization
  API-->>Client: 200 OK (ListAvailableOrganizationsResponse)
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Suggested reviewers

  • micheleRP
✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch update-branch-api

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (5)
cloud-controlplane/x-topics/cloud-regions.md (3)

17-20: Add aria-describedby and unique ID for the sr-only description to improve a11y.

Link the table to its hidden description. Example for the GCP section:

-<details><summary>Regions for GCP</summary>
-<p class="sr-only">Table of cloud regions and throughput tiers for GCP. Use the table headers for more information.</p>
-<table aria-label="Cloud regions and throughput tiers for GCP">
+<details><summary>Regions for GCP</summary>
+<p id="gcp-regions-desc" class="sr-only">Table of cloud regions and throughput tiers for GCP. Use the table headers for more information.</p>
+<table aria-label="Cloud regions and throughput tiers for GCP" aria-describedby="gcp-regions-desc">

Apply the same pattern for AWS and Azure sections with unique IDs.


20-24: Use thead/tbody and header scopes for stronger table semantics.

This improves screen reader support and aligns with accessible table best practices. Example for the GCP table:

-  <tr>
-    <th title="Cloud region name (such as us-central1)">Region</th>
-    <th title="Availability zones in the region (comma-separated)">Zones</th>
-    <th title="Available throughput tiers and cluster types in this region">Throughput Tiers</th>
-  </tr>
+  <thead>
+    <tr>
+      <th scope="col" title="Cloud region name (such as us-central1)">Region</th>
+      <th scope="col" title="Availability zones in the region (comma-separated)">Zones</th>
+      <th scope="col" title="Available throughput tiers and cluster types in this region">Throughput Tiers</th>
+    </tr>
+  </thead>
+  <tbody>

And close tbody before the table ends:

-</table>
+  </tbody>
+</table>

Consider applying the same structure to the AWS and Azure tables.

Also applies to: 348-351


29-41: Minor readability nit: comma-separated zone lists lack spaces.

Optional formatting improvement for readability: add a space after commas in zone lists (for all providers).

Also applies to: 46-58

cloud-controlplane/cloud-controlplane.yaml (2)

328-334: Capitalize and clarify NAT gateway description.

Use the standard acronym and clarify contents.

-        nat_gateways:
-          description: Nat gateway information of the cluster.
+        nat_gateways:
+          description: NAT gateway information for the cluster.
           items:
             type: string
           readOnly: true
           type: array

5659-5689: Tag naming consistency: “User invites” differs in capitalization from other tags.

Most tags are Title Case (“Resource Groups”, “Serverless Regions”). “User invites” uses lowercase invites. If there’s no strong reason, consider “User Invites” for consistency across docs and UI taxonomy.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between c250d8b and 2c64146.

📒 Files selected for processing (2)
  • cloud-controlplane/cloud-controlplane.yaml (54 hunks)
  • cloud-controlplane/x-topics/cloud-regions.md (1 hunks)
🔇 Additional comments (8)
cloud-controlplane/x-topics/cloud-regions.md (1)

16-24: LGTM: Collapsible sections and headers improve scannability and a11y.

The shift to details/summary with an h3 heading plus sr-only descriptions is a solid improvement without altering data.

cloud-controlplane/cloud-controlplane.yaml (7)

3334-3334: Examples correctly include nat_gateways and reflect the new schema.

Sample payloads align with the added read-only field on Cluster. No issues spotted.

Also applies to: 3669-3669, 4064-4064, 4189-4189


1444-1450: HTTPProxySpec docs updated to correct destinations. LGTM.

References now point to the HTTP Proxy overview and API reference under docs.redpanda.com.


2438-2445: SchemaRegistrySpec docs updated to correct destinations. LGTM.

References now point to Cloud Schema Registry docs and SR API reference under docs.redpanda.com.


3247-3249: Info description refinement reads better. LGTM.

Clearer API overview without altering semantics.


2099-2113: OrganizationUpdate type addition looks correct.

Adding mfa_enforced to Organization and OrganizationUpdate matches the intent. No breaking changes observed.


2802-2806: New UpdateOrganizationResponse is well-scoped.

Returning the updated Organization object under a dedicated response type is clear and consistent.


1-5689: Internet Gateways References Removed

Verified that there are no remaining occurrences of internet_gateways in cloud-controlplane/cloud-controlplane.yaml. The spec no longer contains any stale references to internet gateways.

@@ -572,7 +572,7 @@ components:
schema_registry:
$ref: '#/components/schemas/SchemaRegistrySpec'
throughput_tier:
description: '[Throughput tier](https://docs.redpanda.com/api/doc/cloud-controlplane/topic/topic-regions-and-usage-tiers) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'
description: '[Throughput tier](https://docs.redpanda.com/api/cloud-controlplane-api/#api-description) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Good docs link consolidation for throughput_tier, but ensure URL consistency across file.

This updates the anchor to Control Plane API docs. Elsewhere (for example, Create Cluster description on Line 3375) the link uses a .html suffix. Please standardize to one canonical URL to avoid broken links.

Run a quick check to find and review all Control Plane API doc links that include “cloud-controlplane-api”:

If both .html and non-.html variants appear and both resolve, pick one convention and update for consistency.


🏁 Script executed:

#!/bin/bash
rg -n -C2 -e 'cloud-controlplane-api(\.html)?#api-description' -e 'cloud-controlplane-api(\.html)?' -- cloud-controlplane/cloud-controlplane.yaml

Length of output: 1406


Standardize Control Plane API URL suffix

The throughput_tier description at line 575 uses the non-.html variant, while the “Regions” link at line 3375 uses the .html suffix. To avoid confusion and potential broken links, pick one canonical form—preferably the .html version—and apply it consistently:

• File: cloud-controlplane/cloud-controlplane.yaml
– Line 575: update to the .html URL
• (Optional) Scan for any other occurrences of cloud-controlplane-api links and align them to the chosen suffix

Suggested change at line 575:

- description: '[Throughput tier](https://docs.redpanda.com/api/cloud-controlplane-api/#api-description) of the cluster…'
+ description: '[Throughput tier](https://docs.redpanda.com/api/cloud-controlplane-api.html#api-description) of the cluster…'
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
description: '[Throughput tier](https://docs.redpanda.com/api/cloud-controlplane-api/#api-description) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'
description: '[Throughput tier](https://docs.redpanda.com/api/cloud-controlplane-api.html#api-description) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'
🤖 Prompt for AI Agents
In cloud-controlplane/cloud-controlplane.yaml around line 575, the description
URL for the throughput_tier uses the non-.html variant of the
cloud-controlplane-api link; update that URL to the canonical .html form (i.e.,
change the endpoint to include .html) so it matches the Regions link style, and
optionally scan the file for other cloud-controlplane-api links to normalize
them to the chosen .html suffix for consistency.

Comment on lines 4303 to 4344
description: Get a list of available organizations for the user.
operationId: OrganizationService_UpdateOrganization
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/OrganizationUpdate'
required: true
x-originalParamName: organization
responses:
"200":
content:
application/json:
schema:
$ref: '#/components/schemas/ListAvailableOrganizationsResponse'
description: OK
"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: List available organizations for the user
tags:
- Organization
Copy link

@coderabbitai coderabbitai bot Aug 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

PATCH /v1/organizations/current: incorrect description, response schema, and summary.

This endpoint is an update, but:

  • Description says “Get a list of available organizations for the user.”
  • Response schema is ListAvailableOrganizationsResponse.
  • Summary duplicates the ListAvailable... phrasing.

These are contract errors and will mislead SDK generators and consumers. It should return the updated organization (UpdateOrganizationResponse or Organization) and have an update-oriented description/summary.

Apply the following fix:

   /v1/organizations/current:
@@
-    patch:
-      description: Get a list of available organizations for the user.
+    patch:
+      description: Update properties of the current organization.
       operationId: OrganizationService_UpdateOrganization
       requestBody:
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/OrganizationUpdate'
         required: true
-        x-originalParamName: organization
+        x-originalParamName: organization
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ListAvailableOrganizationsResponse'
+                $ref: '#/components/schemas/UpdateOrganizationResponse'
           description: OK
@@
-      summary: List available organizations for the user
+      summary: Update current organization
       tags:
         - Organization

Optionally, consider returning GetCurrentOrganizationResponse for 200 if you prefer reusing an existing envelope, but keep description/summary aligned with “update”.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
description: Get a list of available organizations for the user.
operationId: OrganizationService_UpdateOrganization
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/OrganizationUpdate'
required: true
x-originalParamName: organization
responses:
"200":
content:
application/json:
schema:
$ref: '#/components/schemas/ListAvailableOrganizationsResponse'
description: OK
"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: List available organizations for the user
tags:
- Organization
patch:
description: Update properties of the current organization.
operationId: OrganizationService_UpdateOrganization
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/OrganizationUpdate'
required: true
x-originalParamName: organization
responses:
"200":
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateOrganizationResponse'
description: OK
"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: Update current organization
tags:
- Organization
🤖 Prompt for AI Agents
In cloud-controlplane/cloud-controlplane.yaml around lines 4303 to 4333, the
PATCH /v1/organizations/current operation is misdocumented as a "list" endpoint:
update the description to reflect that this is an update of the current
organization (e.g., "Update the current organization for the user."), change the
200 response schema from ListAvailableOrganizationsResponse to an appropriate
update envelope (e.g., UpdateOrganizationResponse or Organization or
GetCurrentOrganizationResponse if reusing an existing envelope), and update the
summary to an update-oriented phrase ("Update current organization"); also
ensure operationId matches (OrganizationService_UpdateOrganization or similar)
and remove any lingering references to listing to keep the contract consistent
for SDK generators and consumers.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kbatuigas, thank you for addressing the issue! I appreciate you providing the link to the fix in the source repository. This resolves the API documentation inconsistency I identified with the PATCH /v1/organizations/current endpoint.

  (\   /)
 ( ._. )
o_(")(")  *satisfied rabbit*

@@ -331,6 +325,12 @@ components:
description: Unique name of the cluster.
example: development-cluster
type: string
nat_gateways:
description: Nat gateway information of the cluster.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: Nat gateway information of the cluster.
description: NAT gateway information for the cluster.

@@ -572,7 +572,7 @@ components:
schema_registry:
$ref: '#/components/schemas/SchemaRegistrySpec'
throughput_tier:
description: '[Throughput tier](https://docs.redpanda.com/api/doc/cloud-controlplane/topic/topic-regions-and-usage-tiers) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'
description: '[Throughput tier](https://docs.redpanda.com/api/cloud-controlplane-api/#api-description) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: '[Throughput tier](https://docs.redpanda.com/api/cloud-controlplane-api/#api-description) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'
description: '[Throughput tier](https://docs.redpanda.com/api/doc/cloud-controlplane/topic/topic-regions-and-usage-tiers) of the cluster. See also: Redpanda Cloud [Dedicated tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/dedicated-tiers/#dedicated-usage-tiers) and [BYOC tiers](https://docs.redpanda.com/redpanda-cloud/reference/tiers/byoc-tiers/).'

@@ -1441,7 +1441,7 @@ components:
$ref: '#/components/schemas/User'
type: object
HTTPProxySpec:
description: Cluster's HTTP Proxy properties. See [Use Redpanda with the HTTP Proxy API](https://docs.redpanda.com/redpanda-cloud/develop/http-proxy/) and the [HTTP Proxy API reference](https://docs.redpanda.com/api/doc/http-proxy) for more information.
description: Cluster's HTTP Proxy properties. See [Use Redpanda with the HTTP Proxy API](https://docs.redpanda.com/redpanda-cloud/develop/http-proxy/) and the [HTTP Proxy API reference](https://docs.redpanda.com/api/pandaproxy-rest) for more information.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: Cluster's HTTP Proxy properties. See [Use Redpanda with the HTTP Proxy API](https://docs.redpanda.com/redpanda-cloud/develop/http-proxy/) and the [HTTP Proxy API reference](https://docs.redpanda.com/api/pandaproxy-rest) for more information.
description: Cluster's HTTP Proxy properties. See [Use Redpanda with the HTTP Proxy API](https://docs.redpanda.com/redpanda-cloud/develop/http-proxy/) and the [HTTP Proxy API reference](https://docs.redpanda.com/api/doc/http-proxy) for more information.

@@ -2428,7 +2435,7 @@ components:
title: SASL configuration
type: object
SchemaRegistrySpec:
description: Cluster's Schema Registry properties. See the [Schema Registry overview](https://docs.redpanda.com/redpanda-cloud/manage/schema-reg/schema-reg-overview/) and the [Schema Registry API reference](https://docs.redpanda.com/api/doc/schema-registry) for more information.
description: Cluster's Schema Registry properties. See the [Schema Registry overview](https://docs.redpanda.com/redpanda-cloud/manage/schema-reg/schema-reg-overview/) and the [Schema Registry API reference](https://docs.redpanda.com/api/pandaproxy-schema-registry) for more information.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: Cluster's Schema Registry properties. See the [Schema Registry overview](https://docs.redpanda.com/redpanda-cloud/manage/schema-reg/schema-reg-overview/) and the [Schema Registry API reference](https://docs.redpanda.com/api/pandaproxy-schema-registry) for more information.
description: Cluster's Schema Registry properties. See the [Schema Registry overview](https://docs.redpanda.com/redpanda-cloud/manage/schema-reg/schema-reg-overview/) and the [Schema Registry API reference](https://docs.redpanda.com/api/doc/schema-registry) for more information.

@@ -3232,7 +3244,7 @@ components:
x-client-id: dQjapNIAHhF7EQqQToRla3yEII9sUSap
type: oauth2
info:
description: 'Use the Control Plane API to manage resources in your Redpanda Cloud organization such as clusters and networks.'
description: The Redpanda Cloud Control Plane API allows programmatic management of Redpanda Cloud resources including clusters, networks, and resource groups.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: The Redpanda Cloud Control Plane API allows programmatic management of Redpanda Cloud resources including clusters, networks, and resource groups.
description: 'Use the Control Plane API to manage resources in your Redpanda Cloud organization such as clusters and networks.'

tags:
- Clusters
post:
description: Create a Redpanda cluster. Returns a long-running operation. See [Use the Control Plane API](https://docs.redpanda.com/redpanda-cloud/manage/api/controlplane/) for more information. Call `GET /v1/operations/{id}` to check operation state. Refer to [Regions](https://docs.redpanda.com/api/doc/cloud-controlplane/topic/topic-regions-and-usage-tiers) for the list of available regions, zones, and tiers combinations for each cloud provider. For BYOC clusters, follow additional steps to [create a BYOC cluster](https://docs.redpanda.com/redpanda-cloud/manage/api/cloud-byoc-controlplane-api/#additional-steps-to-create-a-byoc-cluster).
description: Create a Redpanda cluster. Returns a long-running operation. See [Use the Control Plane API](https://docs.redpanda.com/redpanda-cloud/manage/api/controlplane/) for more information. Call `GET /v1/operations/{id}` to check operation state. Refer to [Regions](https://docs.redpanda.com/api/cloud-controlplane-api.html#api-description) for the list of available regions, zones, and tiers combinations for each cloud provider. For BYOC clusters, follow additional steps to [create a BYOC cluster](https://docs.redpanda.com/redpanda-cloud/manage/api/cloud-byoc-controlplane-api/#additional-steps-to-create-a-byoc-cluster).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: Create a Redpanda cluster. Returns a long-running operation. See [Use the Control Plane API](https://docs.redpanda.com/redpanda-cloud/manage/api/controlplane/) for more information. Call `GET /v1/operations/{id}` to check operation state. Refer to [Regions](https://docs.redpanda.com/api/cloud-controlplane-api.html#api-description) for the list of available regions, zones, and tiers combinations for each cloud provider. For BYOC clusters, follow additional steps to [create a BYOC cluster](https://docs.redpanda.com/redpanda-cloud/manage/api/cloud-byoc-controlplane-api/#additional-steps-to-create-a-byoc-cluster).
description: Create a Redpanda cluster. Returns a long-running operation. See [Use the Control Plane API](https://docs.redpanda.com/redpanda-cloud/manage/api/controlplane/) for more information. Call `GET /v1/operations/{id}` to check operation state. Refer to [Regions](https://docs.redpanda.com/api/doc/cloud-controlplane/topic/topic-regions-and-usage-tiers) for the list of available regions, zones, and tiers combinations for each cloud provider. For BYOC clusters, follow additional steps to [create a BYOC cluster](https://docs.redpanda.com/redpanda-cloud/manage/api/cloud-byoc-controlplane-api/#additional-steps-to-create-a-byoc-cluster).

@@ -3445,7 +3457,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: Create cluster
summary: Create Cluster
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Create Cluster
summary: Create cluster

@@ -3563,7 +3575,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: Update cluster
summary: Update Cluster
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Update Cluster
summary: Update cluster

@@ -3606,7 +3618,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: Delete cluster
summary: Delete Cluster
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Delete Cluster
summary: Delete cluster

@@ -3696,7 +3708,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: Get cluster
summary: Get Cluster
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Get Cluster
summary: Get cluster

@@ -3769,7 +3781,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: List networks
summary: List Networks
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: List Networks
summary: List networks

@@ -3826,7 +3838,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: Create network
summary: Create Network
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Create Network
summary: Create network

@@ -3869,7 +3881,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: Delete network
summary: Delete Network
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Delete Network
summary: Delete network

@@ -3916,7 +3928,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Please reach out to support.
summary: Get network
summary: Get Network
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Get Network
summary: Get network

@@ -3988,7 +4000,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: An unexpected error response.
summary: List operations
summary: List Operations
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: List Operations
summary: List operations

@@ -4433,7 +4477,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Reach out to support.
summary: List resource groups
summary: List Resource Groups
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: List Resource Groups
summary: List resource groups

@@ -4468,7 +4512,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Reach out to support.
summary: Create resource group
summary: Create Resource Group
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Create Resource Group
summary: Create resource group

@@ -4495,7 +4539,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Not Found
summary: Delete resource group
summary: Delete Resource Group
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Delete Resource Group
summary: Delete resource group

@@ -4538,7 +4582,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Reach out to support.
summary: Get resource group
summary: Get Resource Group
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Get Resource Group
summary: Get resource group

@@ -4589,7 +4633,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: Internal Server Error. Reach out to support.
summary: Update resource group
summary: Update Resource Group
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Update Resource Group
summary: Update resource group

@@ -4654,7 +4698,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: An unexpected error response.
summary: List role bindings
summary: List Role Bindings
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: List Role Bindings
summary: List role bindings

@@ -4687,7 +4731,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: An unexpected error response.
summary: Create role binding
summary: Create Role Binding
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Create Role Binding
summary: Create role binding

@@ -4718,7 +4762,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: An unexpected error response.
summary: Delete role binding
summary: Delete Role Binding
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Delete Role Binding
summary: Delete role binding

@@ -4755,7 +4799,7 @@ paths:
schema:
$ref: '#/components/schemas/rpc.Status'
description: An unexpected error response.
summary: Get role binding
summary: Get Role Binding
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
summary: Get Role Binding
summary: Get role binding

@vbotbuildovich vbotbuildovich force-pushed the update-branch-api branch 2 times, most recently from 275f608 to eff7f15 Compare August 21, 2025 21:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants