v2 Jobs

Create a job (upload or URL)

EP-023-T3 (implemented). In v2.0.0, creating a job requires an API key (scope jobs:create; owner_type=api_key) — there is no web UI for creating jobs, and a session actor gets 403. Idempotency-Key is optional: a repeat with the same key within the account returns the same job (200), without duplicating it.

post/api/v2/jobs

Request

  • Base URL: https://pdf2md.dev
  • URL: https://pdf2md.dev/api/v2/jobs
  • Auth: HTTP bearer

Headers

Idempotency-Keystring
Example:req-123e4567

Idempotency key for safe retries of job-creation requests (ttl 24h)

Request body

urlstring uri required
file_namestring
external_idstring
tagsobject
callback_urlstring uri

v2 §6.8 per-job callback (optional)

callback_secretstring

secret for signing the per-job callback

Response

Idempotent repeat — existing job (same Idempotency-Key)

job_idstring uuid required
status'queued' | 'processing' | 'ready' | 'error' | 'canceled' | 'deleted' required

Job status

file_namestring required
created_atstring date-time required
status_sincestring date-time
pagesinteger nullable
truncatedboolean
output_sizeinteger nullable
download_urlstring uri nullable

populated for ready

tier'anonymous' | 'free' | 'lifetime' | 'builder' | 'pro' | 'business' | 'enterprise' required

EP-069: lifetime is the one-time unlock, ranked BETWEEN free and builder — it raises the interactive limits and carries 600 pages/month, but grants no API keys, hosted MCP, webhooks or batch, so a subscription is genuinely more and its holder may still buy one.

external_idstring nullable
tagsobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.