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