# Azure Cosmos DB Documents API

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

Azure Cosmos DB Documents API is one of 14 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. Tagged areas include Documents. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Documents operations

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/dbs/{dbId}/colls/{collId}/docs` | List documents in a collection |
| POST | `/dbs/{dbId}/colls/{collId}/docs` | Create or query a document |
| GET | `/dbs/{dbId}/colls/{collId}/docs/{docId}` | Get a document |
| PUT | `/dbs/{dbId}/colls/{collId}/docs/{docId}` | Replace a document |
| DELETE | `/dbs/{dbId}/colls/{collId}/docs/{docId}` | Delete a document |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/azure-cosmos-db/refs/heads/main/openapi/azure-cosmos-db-documents-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/rest/api/cosmos-db/

## 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 Collections API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-collections-api/)
- [Azure Cosmos DB Databases API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-databases-api/)
- [Azure Cosmos DB Documents API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-documents-api/)
- [Azure Cosmos DB Offers API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-offers-api/)
- [Azure Cosmos DB Permissions API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-permissions-api/)
- [Azure Cosmos DB Stored Procedures API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-stored-procedures-api/)
- [Azure Cosmos DB Triggers API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-triggers-api/)
- [Azure Cosmos DB User Defined Functions API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-user-defined-functions-api/)
- [Azure Cosmos DB Users API](https://apis.io/apis/azure-cosmos-db/azure-cosmos-db-users-api/)
- [Azure Cosmos DB Collections API](https://apis.io/apis/azure-cosmos-db/microsoft-azure-cosmos-db-collections-api/)

## Tags

Documents

---

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