# Appwrite DocumentsDB API

**Canonical:** https://apis.io/apis/appwrite/appwrite-documentsdb-api/  
**Provider:** Appwrite — https://apis.io/providers/appwrite/  
**Base URL:** https://cloud.appwrite.io/v1  
**Documentation:** https://appwrite.io/docs/references

Appwrite DocumentsDB API is one of 44 APIs that [Appwrite](https://apis.io/providers/appwrite/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Databases. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a GitHub repository.

DocumentsDB — schemaless document storage with documents that evolve with the application, announced 2026-09-02. 36 operations across 18 paths in the Appwrite 2.0.0 OpenAPI.

## Operations (36)

| Method | Path | Summary |
|---|---|---|
| GET | `/documentsdb` | List databases |
| POST | `/documentsdb` | Create database |
| GET | `/documentsdb/specifications` | List specifications |
| GET | `/documentsdb/transactions` | List transactions |
| POST | `/documentsdb/transactions` | Create transaction |
| GET | `/documentsdb/transactions/{transactionId}` | Get transaction |
| PATCH | `/documentsdb/transactions/{transactionId}` | Update transaction |
| DELETE | `/documentsdb/transactions/{transactionId}` | Delete transaction |
| POST | `/documentsdb/transactions/{transactionId}/operations` | Create operations |
| GET | `/documentsdb/{databaseId}` | Get database |
| PUT | `/documentsdb/{databaseId}` | Update database |
| DELETE | `/documentsdb/{databaseId}` | Delete database |
| GET | `/documentsdb/{databaseId}/collections` | List collections |
| POST | `/documentsdb/{databaseId}/collections` | Create collection |
| GET | `/documentsdb/{databaseId}/collections/{collectionId}` | Get collection |
| PUT | `/documentsdb/{databaseId}/collections/{collectionId}` | Update collection |
| DELETE | `/documentsdb/{databaseId}/collections/{collectionId}` | Delete collection |
| GET | `/documentsdb/{databaseId}/collections/{collectionId}/documents` | List documents |
| POST | `/documentsdb/{databaseId}/collections/{collectionId}/documents` | Create document |
| PUT | `/documentsdb/{databaseId}/collections/{collectionId}/documents` | Upsert documents |
| PATCH | `/documentsdb/{databaseId}/collections/{collectionId}/documents` | Update documents |
| DELETE | `/documentsdb/{databaseId}/collections/{collectionId}/documents` | Delete documents |
| GET | `/documentsdb/{databaseId}/collections/{collectionId}/documents/{documentId}` | Get document |
| PUT | `/documentsdb/{databaseId}/collections/{collectionId}/documents/{documentId}` | Upsert a document |
| PATCH | `/documentsdb/{databaseId}/collections/{collectionId}/documents/{documentId}` | Update document |
| DELETE | `/documentsdb/{databaseId}/collections/{collectionId}/documents/{documentId}` | Delete document |
| PATCH | `/documentsdb/{databaseId}/collections/{collectionId}/documents/{documentId}/{attribute}/decrement` | Decrement document attribute |
| PATCH | `/documentsdb/{databaseId}/collections/{collectionId}/documents/{documentId}/{attribute}/increment` | Increment document attribute |
| GET | `/documentsdb/{databaseId}/collections/{collectionId}/indexes` | List indexes |
| POST | `/documentsdb/{databaseId}/collections/{collectionId}/indexes` | Create index |
| GET | `/documentsdb/{databaseId}/collections/{collectionId}/indexes/{key}` | Get index |
| DELETE | `/documentsdb/{databaseId}/collections/{collectionId}/indexes/{key}` | Delete index |
| POST | `/documentsdb/{databaseId}/failovers` | Create failover |
| GET | `/documentsdb/{databaseId}/operations` | List operations |
| GET | `/documentsdb/{databaseId}/replicas` | Get replicas |
| GET | `/documentsdb/{databaseId}/status` | Get status |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/appwrite/refs/heads/main/openapi/appwrite-documentsdb-api-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/appwrite/refs/heads/main/overlays/appwrite-documentsdb-overlay.yaml
- **Documentation** — https://appwrite.io/docs
- **APIReference** — https://appwrite.io/docs/references
- **GitHubRepository** — https://github.com/appwrite/appwrite

## Other Appwrite APIs (12)

- [Appwrite Project API](https://apis.io/apis/appwrite/appwrite-project-api/)
- [Appwrite TablesDB API](https://apis.io/apis/appwrite/appwrite-tablesdb-api/)
- [Appwrite Account API](https://apis.io/apis/appwrite/appwrite-account-api/)
- [Appwrite Databases API](https://apis.io/apis/appwrite/appwrite-databases-api/)
- [Appwrite Domains API](https://apis.io/apis/appwrite/appwrite-domains-api/)
- [Appwrite Messaging API](https://apis.io/apis/appwrite/appwrite-messaging-api/)
- [Appwrite Organizations API](https://apis.io/apis/appwrite/appwrite-organizations-api/)
- [Appwrite Users API](https://apis.io/apis/appwrite/appwrite-users-api/)
- [Appwrite PostgreSQL API](https://apis.io/apis/appwrite/appwrite-postgresql-api/)
- [Appwrite VectorsDB API](https://apis.io/apis/appwrite/appwrite-vectorsdb-api/)
- [Appwrite MySQL API](https://apis.io/apis/appwrite/appwrite-mysql-api/)
- [Appwrite MongoDB API](https://apis.io/apis/appwrite/appwrite-mongo-api/)

## Tags

Databases

---

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