Skip to main content
Delete Document
curl --request DELETE \
  --url https://api.doctly.ai/api/v1/documents/{id} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Document deleted successfully"
}
Delete a document and all its associated files (original upload and processed output). This action is permanent and cannot be undone.

​
Request

​
Headers

​
Authorization
string
required
Bearer token authentication. Example: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the document to delete

​
Example Request

curl -X DELETE https://api.doctly.ai/api/v1/documents/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
message
string
Success confirmation message

​
Example Responses

{
  "message": "Document deleted successfully"
}
This action is permanent. Deleting a document removes:
  • The original uploaded file
  • The processed output (Markdown or extraction result)
  • All associated metadata
Make sure to download any files you need before deleting.

​
Bulk Deletion Example

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Get documents older than 30 days
from datetime import datetime, timedelta
cutoff = (datetime.now() - timedelta(days=30)).isoformat()

response = requests.get(
    "https://api.doctly.ai/api/v1/documents",
    headers=headers,
    params={"date_to": cutoff}
)

old_docs = response.json()["data"]

# Delete each document
for doc in old_docs:
    requests.delete(
        f"https://api.doctly.ai/api/v1/documents/{doc['id']}",
        headers=headers
    )
    print(f"Deleted: {doc['file_name']}")

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token

Path Parameters

​
id
string<uuid>
required

Document ID

Response

Document deleted

​
message
string
required