# Azure Cosmos DB Subscriptions API

**Canonical:** https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-subscriptions-api/  
**Provider:** Azure Cosmos DB — https://apis.io/providers/azure-cosmos-db/  
**Base URL:** https://management.azure.com  
**Documentation:** https://learn.microsoft.com/en-us/rest/api/cosmos-db/

Azure Cosmos DB Subscriptions API is one of 13 APIs that [Azure Cosmos DB](https://apis.io/providers/azure-cosmos-db/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Subscription. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

The Subscriptions API from Azure Cosmos DB — 142 operation(s) for subscriptions.

## Operations (60 of 218)

| Method | Path | Summary |
|---|---|---|
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/cassandraClusters` | Cassandra clusters list by subscription |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/databaseAccounts` | Database accounts list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/fleets` | Fleet list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations` | Locations list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}` | Locations get |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts` | Restorable database accounts list by location |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}` | Restorable database accounts get by location |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableGraphs` | Restorable gremlin graphs list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableGremlinDatabases` | Restorable gremlin databases list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableGremlinResources` | Restorable gremlin resources list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableMongodbCollections` | Restorable mongodb collections list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableMongodbDatabases` | Restorable mongodb databases list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableMongodbResources` | Restorable mongodb resources list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlContainers` | Restorable sql containers list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlDatabases` | Restorable sql databases list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources` | Restorable sql resources list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableTableResources` | Restorable table resources list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableTables` | Restorable tables list |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/restorableDatabaseAccounts` | Restorable database accounts list |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters` | Cassandra clusters list by resource group |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}` | Cassandra clusters get |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}` | Cassandra clusters create update |
| PATCH | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}` | Cassandra clusters update |
| DELETE | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}` | Cassandra clusters delete |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters` | Cassandra data centers list |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}` | Cassandra data centers get |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}` | Cassandra data centers create update |
| PATCH | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}` | Cassandra data centers update |
| DELETE | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}` | Cassandra data centers delete |
| POST | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/deallocate` | Cassandra clusters deallocate |
| POST | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/invokeCommand` | Cassandra clusters invoke command |
| POST | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/start` | Cassandra clusters start |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/status` | Cassandra clusters status |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts` | Database accounts list by resource group |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}` | Database accounts get |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}` | Database accounts create or update |
| PATCH | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}` | Database accounts update |
| DELETE | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}` | Database accounts delete |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces` | Cassandra resources list cassandra keyspaces |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}` | Cassandra resources get cassandra keyspace |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}` | Cassandra resources create update cassandra keyspace |
| DELETE | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}` | Cassandra resources delete cassandra keyspace |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables` | Cassandra resources list cassandra tables |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}` | Cassandra resources get cassandra table |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}` | Cassandra resources create update cassandra table |
| DELETE | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}` | Cassandra resources delete cassandra table |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}/throughputSettings/default` | Cassandra resources get cassandra table throughput |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}/throughputSettings/default` | Cassandra resources update cassandra table throughput |
| POST | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}/throughputSettings/default/migrateToAutoscale` | Cassandra resources migrate cassandra table to autoscale |
| POST | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}/throughputSettings/default/migrateToManualThroughput` | Cassandra resources migrate cassandra table to manual throughput |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default` | Cassandra resources get cassandra keyspace throughput |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default` | Cassandra resources update cassandra keyspace throughput |
| POST | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default/migrateToAutoscale` | Cassandra resources migrate cassandra keyspace to autoscale |
| POST | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default/migrateToManualThroughput` | Cassandra resources migrate cassandra keyspace to manual throughput |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraRoleAssignments` | Cassandra resources list cassandra role assignments |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraRoleAssignments/{roleAssignmentId}` | Cassandra resources get cassandra role assignment |
| PUT | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraRoleAssignments/{roleAssignmentId}` | Cassandra resources create update cassandra role assignment |
| DELETE | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraRoleAssignments/{roleAssignmentId}` | Cassandra resources delete cassandra role assignment |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraRoleDefinitions` | Cassandra resources list cassandra role definitions |
| GET | `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraRoleDefinitions/{roleDefinitionId}` | Cassandra resources get cassandra role definition |

…and 158 more operations. They are listed in full on the page.

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/azure-cosmos-db/openapi/azure-cosmos-db-subscriptions-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/rest/api/cosmos-db/
- **JSONSchema** — https://artifacts.apis.io/azure-cosmos-db/json-schema/azure-cosmos-db-database-account-get-results-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-cosmos-db/json-schema/azure-cosmos-db-sql-user-defined-function-get-results-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-cosmos-db/json-schema/azure-cosmos-db-throughput-settings-get-results-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-cosmos-db/json-schema/azure-cosmos-db-cassandra-keyspace-get-results-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-cosmos-db/json-schema/azure-cosmos-db-mongo-dbcollection-get-results-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-cosmos-db/json-schema/azure-cosmos-db-sql-stored-procedure-get-results-schema.json

## Other Azure Cosmos DB APIs (12)

- [Azure Cosmos DB Data Plane REST API](https://apis.io/apis/azure-cosmos-db/data-plane-api/)
- [Azure Cosmos DB Resource Provider API](https://apis.io/apis/azure-cosmos-db/resource-provider-api/)
- [Azure Cosmos DB Data Transfer API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-datatransfer-api/)
- [Azure Cosmos DB Fleets API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-fleets-api/)
- [Azure Cosmos DB Graph API Compute API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-graphapicompute-api/)
- [Azure Cosmos DB Materialized Views Builder API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-materializedviewsbuilder-api/)
- [Azure Cosmos DB Notebook Workspaces Resource API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-notebookworkspacesresource-api/)
- [Azure Cosmos DB Operations API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-operations-api/)
- [Azure Cosmos DB Private Link Resources API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-privatelinkresources-api/)
- [Azure Cosmos DB Providers API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-providers-api/)
- [Azure Cosmos DB Sql Dedicated Gateway API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-sqldedicatedgateway-api/)
- [Azure Cosmos DB Private Endpoint Connections API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-private-endpoint-connections-api/)

## Tags

Subscription

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-subscriptions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/azure-cosmos-db/.
