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
  • Request Format
  • Response Format

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.