Delete a document (owner)

DELETE

/api/v1/documents/{id}

App integration: Deletion is owner-only and removes the cloud document; ask for explicit destructive intent in your app. Use If-Match, remove the item from your local view after success, and let other devices process its tombstone. This is different from disconnecting an integration or deleting an account.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://handwrites.io/oauth/authorize

Token URL: https://handwrites.io/api/oauth/token

Refresh URL: https://handwrites.io/api/oauth/token

Scopes:

documents:delete-Delete documents you own

Path Params

Header Params

Responses

🟢204

Deleted.

Headers

This response does not have a body.

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🟠412PreconditionFailed

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/api/v1/documents/' \
--header 'If-Match;' \
--header 'Authorization: Bearer <token>'

Response Example

400 - Example 1

{
    "error": {
        "code": "string",
        "message": "string"
    }
}

Modified at 2026-10-26 12:58:15

Change title, text, content type or language

The document's text