ConverterHQDevelopers
Documentation

Signed URLs

Safe browser-triggered conversions without exposing an API key.

ConverterHQ uses signed URLs for storage uploads, storage downloads and policy-bound conversion execution. These are distinct features with different trust boundaries.

Policy-bound conversion
Browser or clientNo permanent API key
Signed URLExpiry + HMAC policy
Workflow JobFrozen version + limits
OutputSigned download
The signed conversion policy constrains what the unauthenticated caller can vary before any Job is created.

Three URL types

Upload URLs authorize one File upload. Download URLs authorize temporary read access to one output. Signed conversion URLs authorize a constrained Workflow without revealing your API key.

Conversion policies

Signed conversion bases enforce expiry and can constrain source hosts, maximum file size, maximum credits, maximum uses and a frozen Workflow version. Rotate a base secret without changing your permanent API credentials.

Validated variables

A signed URL may supply only variables declared by the Workflow schema. Types, required values, enums, limits and patterns are validated before the Workflow definition is rendered, so a caller cannot mutate arbitrary Job fields.

Caching

Optional cache keys can reuse an existing valid output for repeated requests, eliminating redundant processing and improving margins and latency.