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

Azure Kubernetes Service Agent Pools API

Operations for managing agent pools (node pools) within AKS clusters

Azure Kubernetes Service Agent Pools API is one of 7 APIs that Azure Kubernetes Service publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Agent Pools. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, authentication docs, pricing, rate-limit docs, and 1 JSON Schema.

This API exposes 9 operations across 7 paths, and defines 10 schemas. It is described by OpenAPI 3.2.0, at version 2025-10-01.

Requests are made against a single base URL, https://management.azure.com.

9 operations 7 paths 10 schemas 1 DELETE4 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025-10-01
Base URL
https://management.azure.com
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Azure Kubernetes Service Agent Pools API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (azure_auth) using the implicit flow, exposing 1 scope. By default, every request must be authenticated.

  • azure_auth — Azure Active Directory OAuth2 Flow.

Paths & Operations 9

Across 7 paths, the API surfaces 9 operations — 1 DELETE, 4 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Agent Pools 9

Operations for managing agent pools (node pools) within AKS clusters

GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools
Azure Kubernetes Service List Agent Pools
AgentPools_List 4 params → 200default
GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}
Azure Kubernetes Service Get an Agent Pool
AgentPools_Get 5 params → 200default
PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}
Azure Kubernetes Service Create or Update an Agent Pool
AgentPools_CreateOrUpdate 7 params body → 200201default
DELETE
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}
Azure Kubernetes Service Delete an Agent Pool
AgentPools_Delete 5 params → 202204default
GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeProfiles/default
Azure Kubernetes Service Get the Upgrade Profile for an Agent Pool
AgentPools_GetUpgradeProfile 5 params → 200default
GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/availableAgentPoolVersions
Azure Kubernetes Service Get Available Agent Pool Versions
AgentPools_GetAvailableAgentPoolVersions 5 params → 200default
POST
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeNodeImageVersion
Azure Kubernetes Service Upgrade Node Image Version
AgentPools_UpgradeNodeImageVersion 5 params → 200202default
POST
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/abort
Azure Kubernetes Service Abort Latest Operation on an Agent Pool
AgentPools_AbortLatestOperation 5 params → 202204default
POST
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/deleteMachines
Azure Kubernetes Service Delete Specific Machines in an Agent Pool
AgentPools_DeleteMachines 5 params body → 202default

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are AgentPoolProperties (38 properties), AgentPool (4 properties), AgentPoolUpgradeProfile (4 properties), AgentPoolAvailableVersions (4 properties). Each schema is shown below with its type and property counts.

AgentPoolProperties
object
Properties for the container service agent pool profile.
38 properties
AgentPoolDeleteMachinesParameter
object
The parameters for deleting machines in an agent pool.
1 property 1 required
AgentPoolUpgradeSettings
object
Settings for upgrading an agentpool.
3 properties
CloudError
object
An error response from the Container service.
1 property
AgentPoolUpgradeProfile
object
The list of available upgrades for an agent pool.
4 properties
AgentPoolAvailableVersions
object
The available agent pool versions.
4 properties
AgentPoolListResult
object
The response from the List Agent Pools operation.
2 properties
AgentPool
object
Agent pool resource within a managed cluster.
4 properties
CreationData
object
Data used when creating a target resource from a source resource.
1 property
PowerState
object
Describes the Power State of the cluster.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

microsoft-azure-kubernetes-service-agent-pools-api-openapi.yml Raw ↑

Other APIs Azure Kubernetes Service publishes across the network.

Azure Kubernetes Service Maintenance Configurations API
Azure Kubernetes Service Snapshots API
Azure Kubernetes Service Private Endpoint Connections API
Azure Kubernetes Service Trusted Access Role Bindings API
Azure Kubernetes Service kubectl API
Azure Kubernetes Service Managed Clusters API
Where this information came from

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

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

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

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