Sign in
workflows

Validate a workflow graph without saving it

Dry-run validation. ?gate=draft_save answers "would this save as a draft?" (completeness findings reported but non-blocking); the default activate answers "would this activate?" — the same split the MCP validate_workflow_graph tool exposes.

post/v1/workflows/revisions/{revision_id}/graph/validate

Path parameters

revision_idstring uuid required

Query parameters

gate'draft_save' | 'activate'

Request body

compiled_graphobject required
base_versioninteger nullable

Response

Successful Response

validboolean required
error_countinteger required
warning_countinteger required
suggestion_countinteger required
normalized_graphobject nullable
blocking_error_countinteger nullable

Changes

Changed in 1 of the 3 revisions of this API.9

  • 5a5597ebb2d69See the full diff
    • ○

      added the new optional query request parameter gate

      new-optional-request-parameter

    • ○

      added the new optional request property base_version

      new-optional-request-property

    • ○

      added the optional property blocking_error_count to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property retry_after to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property retry_after to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property retry_after to the response with the 404 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 404 status

      response-optional-property-added

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog