Skip to Navigation
Delete a Document
-
Use this endpoint with the
**DELETE**method to delete one document from the database:
<server URL>/databases/<database name>/docs?id=<document ID> -
In this page:
Example
This is a cURL request to delete the document "employees/1-A" from a database named "Example" on our playground server:
curl -X DELETE "http://live-test.ravendb.net/databases/Example/docs?id=employees/1-A"Response:
HTTP/1.1 204
status: 204
Server: nginx
Date: Tue, 27 Aug 2019 11:40:12 GMT
Connection: keep-alive
Raven-Server-Version: 4.2.3.42
Request Format
This is the general format of the cURL request:
curl -X DELETE "<server URL>/databases/<database name>/docs?id=<document ID>"
--header "If-Match: <expected change vector>"| Query Parameters | Description | Required |
|---|---|---|
| id | ID of a document to be deleted. | Yes |
| Headers | Description | Required |
|---|---|---|
| If-Match | Expected change vector. If it matches the server-side change vector the document is deleted, if they don't match a concurrency exception is thrown. | No |
Response Format
| Header | Description |
|---|---|
| Content-Type | MIME media type and character encoding. This should always be: application/json; charset=utf-8. |
| Raven-Server-Version | Version or RavenDB the responding server is running |
| HTTP Status Code | Description |
|---|---|
204 |
The document was successfully deleted, or no document with the specified ID exists. |
409 |
The change vector submitted did not match the server-side change vector. A concurrency exception is thrown. |
Related Articles