Jobs

Create jobs, poll status, and download results safely.

The API is job-first so long-running conversions, premium-provider workflows, and future batch jobs can run without forcing clients to keep one HTTP request open.

Create a generic tool job

Use POST /v1/tools/{tool_slug}/jobs for API-enabled tools. Use POST /v1/jobs when you want to pass the tool slug in the JSON body.

Idempotency

Send an Idempotency-Key header when creating jobs from a retrying client. Reusing the same key prevents accidental duplicate charges.

Polling

Use GET /v1/jobs/{job_id} to check status. A queued or processing job returns status metadata; a completed job can return download lookup details.

Downloads

Use GET /v1/jobs/{job_id}/download to obtain a signed temporary download URL or a not-ready response. Do not log signed URLs.

curl -X POST https://fileza.ai/v1/tools/compress-pdf/jobs \
  -H "Authorization: Bearer fpe_live_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: job_12345" \
  -d '{"inputUrl":"https://example.com/input.pdf"}'

Need help?

Include your request ID, endpoint, timestamp, and account email when contacting support. Never send raw API keys, provider secrets, OAuth tokens, or signed download URLs.

Contact API support