ConverterHQDevelopers
API v1

Workflows

Sla herbruikbare Job-definities op en versioneer ze.

Een Workflow is een herbruikbaar Job-template voor API, signed URLs, MCP, Zapier en Job Builder.

Onveranderlijke versies

Elke wijziging maakt een immutable versie zodat historische Jobs en signed URLs reproduceerbaar blijven.

Variabelen

Definieer een schema voor callerwaarden. ConverterHQ valideert types, required fields, enums, limieten en patterns voordat de Job-definitie wordt gerenderd.

Workflow uitvoeren

POST /v1/workflows/{id}/run accepteert variables, client_reference_id en metadata en maakt een gewone Job. Gebruik Idempotency-Key voor veilige retries.

Productiecontroles

Pin externe automatisering op een Workflowversie, wijzig gedrag via nieuwe versies en retire oude versies pas nadat callers zijn gemigreerd.