# Manage Redpanda using the Admin API > For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt) --- title: Manage Redpanda using the Admin API latest-redpanda-tag: v26.1.9 latest-console-tag: v3.7.3 latest-operator-version: v26.1.4 # EOL = End-of-Life (support lifecycle status) page-is-nearing-eol: "false" page-is-past-eol: "false" page-eol-date: March 31, 2027 latest-connect-version: 4.93.0 docname: use-admin-api page-component-name: streaming page-version: "26.1" page-component-version: "26.1" page-component-title: Streaming page-relative-src-path: use-admin-api.adoc page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/manage/pages/use-admin-api.adoc description: Manage components of a Redpanda cluster, such as individual brokers and partition leadership. The Redpanda Admin API also allows you to perform operations that are specific to Redpanda Streaming and cannot be done using the standard Kafka API. page-git-created-date: "2025-11-19" page-git-modified-date: "2026-05-26" support-status: supported --- The Redpanda Admin API allows you to manage your cluster and perform operations specific to Redpanda Streaming that are not available through the standard Kafka API. You can call the Admin API using any HTTP client. Most Admin API operations are also available using [`rpk`](https://docs.redpanda.com/streaming/current/get-started/intro-to-rpk/), a CLI tool that interacts with the Admin API under the hood. Redpanda v25.3 introduces new endpoints to the Admin API that are served with [ConnectRPC](https://connectrpc.com/docs/introduction). New Redpanda features and operations available starting in v25.3 are accessible as RPC services through these new endpoints. Existing Admin API operations from versions earlier than 25.3 remain available at their current URLs and you can continue to use them as usual (including with rpk v25.3 and later). ## [](#prerequisites)Prerequisites - A running Redpanda Streaming cluster. - Superuser privileges, if [authentication](https://docs.redpanda.com/streaming/current/manage/security/authentication/#enable-authentication) is enabled on your cluster for the Admin API. For more information, see [Configure Authentication](https://docs.redpanda.com/streaming/current/manage/security/authentication/#create-superusers). (Some endpoints are read-only and do not require superuser access.) - A tool to make HTTP requests, such as `curl`, or client libraries for your programming language of choice. - For Admin API operations introduced in v25.3 and later, you can also make requests using a ConnectRPC client. You can install the Connect plugin for your preferred language and use the Protobuf compiler to generate an SDK. These RPC services are also available in a Buf module, which you can access through the [Buf Schema Registry](https://buf.build/redpandadata/core/docs/dev:redpanda.core.admin.v2). The [Buf CLI](https://buf.build/docs/cli/) provides an easy way to generate client SDKs. ## [](#use-the-admin-api)Use the Admin API Starting in Redpanda v25.3, in addition to RESTful HTTP endpoints, the Admin API serves new endpoints as ConnectRPC services. You can use either autogenerated Protobuf clients or HTTP requests to call ConnectRPC services. Both new and legacy (RESTful) endpoints are accessible on the same port (default: 9644), but they use different URL paths. > 📝 **NOTE** > > Legacy Admin API endpoints remain available and fully supported. Use them for operations not yet available as ConnectRPC services. ### [](#authentication)Authentication If authentication is enabled on your cluster, you must provide credentials with each request, either using HTTP Basic authentication or by including an `Authorization` header with a bearer token. For example: ```bash curl -u : -X GET "http://localhost:9644/v1/cluster_config" ``` ### [](#use-legacy-restful-endpoints)Use legacy (RESTful) endpoints The base URL for all requests to the legacy endpoints is: ```none http://:/v1/ ``` For a full list of available endpoints, see the [Admin API Reference](https://docs.redpanda.com/api/doc/admin/v1/). Select "v1" in the version selector to view legacy endpoints. #### [](#example-request)Example request To use the Admin API to [decommission a broker](https://docs.redpanda.com/streaming/current/manage/cluster-maintenance/decommission-brokers/): ##### curl Send a PUT request to the [`/v1/brokers/{broker_id}/decommission`](https://docs.redpanda.com/api/doc/admin/operation/operation-decommission) endpoint: ```bash curl \ -u : \ --request PUT 'http://:/v1/brokers//decommission' ``` ##### rpk For Linux deployments only, run [`rpk redpanda admin brokers decommission`](https://docs.redpanda.com/streaming/current/reference/rpk/rpk-redpanda/rpk-redpanda-admin-brokers-decommission/): ```bash rpk redpanda admin brokers decommission ``` ### [](#use-connectrpc-endpoints)Use ConnectRPC endpoints The new endpoints differ from the legacy endpoints in the following ways: - You can use a generated ConnectRPC client to call methods directly from your application code, or send `curl` requests with a JSON payload, as with legacy endpoints. - URL paths use the fully-qualified names of the ConnectRPC services. - ConnectRPC endpoints accept only POST requests. Use ConnectRPC endpoints with features introduced in v25.3 such as: - Shadowing - Connected client monitoring For a full list of available endpoints, see the [Admin API Reference](https://docs.redpanda.com/api/doc/admin/v2/). Select "v2" in the version selector to view the ConnectRPC endpoints. #### [](#example-request-2)Example request To fail over a specific shadow topic from an existing shadow link: ##### curl Send a POST request to the [`redpanda.core.admin.v2.ShadowLinkService/FailOver`](https://docs.redpanda.com/api/doc/admin/v2/operation/operation-redpanda-core-admin-v2-shadowlinkservice-failover) endpoint: ```bash curl \ -u : \ --request POST 'http://:/redpanda.core.admin.v2.ShadowLinkService/FailOver' \ --header "Content-Type: application/json" \ --data '{ "name": "", "shadowTopicName": "" }' ``` - Request headers `Connect-Protocol-Version` and `Connect-Timeout-Ms` are optional. - v2 endpoints also accept binary-encoded Protobuf request bodies. Use the `Content-Type: application/proto` header. ##### rpk Run `rpk shadow failover`: ```bash rpk shadow failover --topic ```