ConverterHQDevelopers
API v1

Workflows

Salva e versiona definizioni Job riutilizzabili.

Un Workflow è un template Job riutilizzabile da API, URL firmati, MCP, Zapier e Job Builder.

Versioni immutabili

Ogni modifica crea una versione immutabile così Jobs storici e signed URL restano riproducibili.

Variabili

Definisci uno schema per i valori del chiamante. ConverterHQ valida tipi, required, enum, limiti e pattern prima di renderizzare la definizione Job.

Eseguire un Workflow

POST /v1/workflows/{id}/run accetta variables, client_reference_id e metadata e crea un Job normale. Usa Idempotency-Key per retry sicuri.

Controlli di produzione

Fissa le automazioni a una versione Workflow, evolvi con nuove versioni e ritira le vecchie solo dopo la migrazione dei chiamanti.