API · Documents

Delete a document

DELETE


        /api/v1/documents/{id}

Purges the payload and removes the document. Usage records are kept. While a question about the document is still being answered the delete is refused with 409 conflict; try again a moment later.

Path parameters

id string required

The document's id.

Returns 204

Deleted

Errors

401
Missing, revoked or expired key
402
Payment required. Either the plan's monthly request quota is spent (quota_exceeded, trial plans only — pay as you go is never capped) or the workspace is out of credit (insufficient_credits).
404
No document or query with that id for this key (documents are scoped to the key's workspace and live/test mode)
409
A query on this document is still running
429
Per-second burst limit for the plan exceeded; retry after Retry-After seconds

Every error has the same shape. See Errors.

Request Delete a document

curl -X DELETE "$NORTHDOC_API/documents/$DOC_ID" \
  -H "Authorization: Bearer $NORTHDOC_KEY" \
  -i

Purges the file, its text and its results immediately, ahead of the retention clock. Usage records survive, so your billing history and GET /usage are unaffected.

Response

{
  "error": {
    "message": "Missing or invalid API key.",
    "type": "unauthorized"
  }
}

{
  "error": {
    "limit": 10000,
    "message": "Monthly request quota exhausted.",
    "resets_at": "2026-10-01T00:00:00Z",
    "type": "quota_exceeded",
    "upgrade_url": "https://northdoc.northcape.tech/app/acme-robotics/billing",
    "used": 10000
  }
}

{
  "error": {
    "message": "No such document.",
    "type": "not_found"
  }
}

{
  "error": {
    "message": "A query on this document is still running. Try again in a moment.",
    "type": "conflict"
  }
}

{
  "error": {
    "limit": 2,
    "message": "Too many requests. Limit is 2 per second.",
    "retry_after": 1,
    "type": "rate_limited"
  }
}