AI usage, retention & deletion
Read private AI processing activity and token counts, understand expiry and delete completed results safely.
Private activity reporting#
Use GET /v1/ai/jobs/usage?days=30 with your existing API project key, or a logged-in browser session. Allowed days: 1–90. Reports are isolated by both HQTools account and API project, returning counts per operation and status, plus recorded input/output tokens. Deleted jobs are excluded; expired completed jobs may be counted without retaining their document content.
curl 'https://api.pdfhq.io/v1/ai/jobs/usage?days=30' \
-H 'x-api-key: PROJECT_API_KEY'These figures are processing observability, not your invoice, quota entitlement or wallet balance. HQTools remains authoritative for credit charges and payments. No original PDF, prompt or model answer is returned in the usage endpoint.
AI content expiry and erasure#
Job status responses include content_expires_at and content_purged_at. Expired AI responses are no longer accessible, even if automatic deletion has not run yet. Completed jobs can also be deleted manually through DELETE /v1/ai/jobs/{job_id}. Invoice CSV exports return HTTP 410 after expiry.
Default AI prompt and generated-result retention is seven days and is configurable from 1 to 30 days. This covers AI requests and results, not original uploaded PDFs, platform backups, logs or external provider retention. Contact support about document lifecycle and subprocessors for regulated workloads.
Uncertain provider charges#
A job marked needs_reconciliation is not retried automatically: a provider timeout can occur after a billable inference. Support verifies provider and HQTools records, then approves an audited refund/release where appropriate. Never submit a new request just to recover a timed-out existing operation.
