API Reference
Complete reference for the jsondb.cloud REST API (v1).
Base URL
https://api.jsondb.cloud/v1/dbAuthentication
All requests require an API key in the Authorization header:
Authorization: Bearer jdb_sk_live_...All Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/db/{ns}/{collection} | Create a document |
| GET | /v1/db/{ns}/{collection}/{id} | Get a document |
| PUT | /v1/db/{ns}/{collection}/{id} | Replace a document |
| PATCH | /v1/db/{ns}/{collection}/{id} | Partial update (merge or JSON Patch) |
| DELETE | /v1/db/{ns}/{collection}/{id} | Delete a document |
| GET | /v1/db/{ns}/{collection} | List & query documents |
| POST | /v1/db/{ns}/{collection}/_bulk | Bulk operations |
| PUT | /v1/db/{ns}/{collection}/_schema | Set collection schema |
| GET | /v1/db/{ns}/{collection}/_schema | Get collection schema |
| POST | /v1/db/{ns}/{collection}/_validate | Dry-run schema validation |
| POST | /v1/db/{ns}/{collection}/_webhooks | Register webhook |
| GET | /v1/db/{ns}/{collection}/_webhooks | List webhooks |
| GET | /v1/db/{ns}/{collection}/{id}/versions | List document versions |
| POST | /v1/db/{ns}/{collection}/{id}/versions/{v}/restore | Restore to version |
| POST | /v1/db/{ns}/{collection}/_import | Bulk import (JSON/CSV/NDJSON) |
| GET | /v1/db/{ns}/{collection}/_export | Export collection |