Azure Cosmos DB: REST API Reference
Azure Cosmos DB is a globally distributed multi-model database that supports the document, graph, and key-value data models. The content in this section is for creating, querying, and managing document resources using the SQL API via REST.
The Azure Cosmos DB REST API provides programmatic access to Azure Cosmos DB resources to create, query, and delete databases, document collections, and documents. To perform operations on Azure Cosmos DB resources, you send HTTPS requests with a supported method:
DELETE to an endpoint that targets a resource collection or a specific resource. This section explains how to work with resources by using the REST API.
The follow video gives a great introduction to Azure Cosmos DB REST APIs.
Supported REST API Versions
The following table lists the supported REST API versions by the Azure Cosmos DB service. The version must be specified via the
x-ms-version header in every request. If not specified, the service defaults to the latest version
|Version||Change introduced||Retirement date|
|2018-12-31||Partitioned collections automatic migration|
|2018-09-17||Composite and additional spatial indexing|
|2018-08-31||Dynamic collection scaling improvements|
|2018-06-18||Multi-region write support|
|2017-11-15||Multi-region Strong Consistency|
|2017-05-03||Large partition key|
|2017-01-19||Lowered minimum throughput for partitioned collections to 2500 RU/s|
|2015-06-03||Order By support|
|2015-04-08||DocumentDB general availability (now part of Azure Cosmos DB)|
|2014-08-21||DocumentDB public preview (now part of Azure Cosmos DB)||February 29th, 2016|
Cosmos DB Resources
- Stored Procedures
- User Defined Functions
See Access control for how to authorize requests. For general information about request and response options, see the following articles: