ConverterHQDevelopers
API v1

Workflows

Enregistrez et versionnez des définitions de Job réutilisables.

Un Workflow est un modèle de Job réutilisable par l’API, les URLs signées, MCP, Zapier et le Job Builder.

Versions immuables

Chaque modification crée une version immuable afin que Jobs historiques et URLs signées restent reproductibles.

Variables

Déclarez un schéma de variables pour les valeurs fournies par l’appelant. ConverterHQ valide types, champs requis, enums, limites et patterns avant de rendre la définition du Job.

Exécuter un Workflow

POST /v1/workflows/{id}/run accepte variables, client_reference_id et metadata puis crée un Job ordinaire. Utilisez Idempotency-Key pour rejouer sans dupliquer une exécution logique.

Contrôles de production

Épinglez les automatisations externes à une version de Workflow, faites évoluer le comportement par nouvelle version et retirez les anciennes versions seulement lorsque les appelants ont migré.