Skip to documentation
Workflow Developer API

Validate Workflow Definition

Preflight canonical workflow JSON against save, audit, and public API rules. This operation does not persist anything. A definition that fails validation still returns HTTP 200 with ``viable=false`` and machine-actionable findings.

POST/developer/v1/workflows/validate

Authorizations

Authorization
stringheaderrequired

Send your GenHealth credential as Bearer <YOUR_API_KEY>. This endpoint requires workflow:read for the authenticated organization.

Headers

Accept
stringheader

Response media type. Use application/json for the current API.

Parameters

This endpoint does not define request parameters.

Request body

Send an application/json request body. This body is required.

WorkflowDefinitionValidationRequest
definitionA genhealth.workflow_definition import envelope. Any JSON value is accepted here so schema mistakes can be returned as structured validation results.WorkflowImportEnvelope | JsonValue

Responses

200Successful Response
WorkflowDefinitionValidationResult
successboolean
schema_validboolean
graph_validboolean
policy_validboolean
workflow_validboolean
viableboolean
readinessstring
runtime_verifiedboolean
422Validation Error
HTTPValidationError
detailarray<ValidationError>