ConverterHQDevelopers
API v1

Workflows

Salve e versione definições de Job reutilizáveis.

Um Workflow é um template reutilizável por API, URLs assinadas, MCP, Zapier e Job Builder.

Versões imutáveis

Cada alteração cria uma versão imutável para manter Jobs históricos e URLs assinadas reproduzíveis.

Variáveis

Defina um schema para valores do chamador. O ConverterHQ valida tipos, obrigatórios, enums, limites e patterns antes de renderizar a definição do Job.

Executar um Workflow

POST /v1/workflows/{id}/run aceita variables, client_reference_id e metadata e cria um Job normal. Use Idempotency-Key para retries seguros.

Controles de produção

Fixe automações a uma versão, evolua com novas versões e retire as antigas apenas depois que os chamadores migrarem.