Workflow Developer API

Audit Workflow

Audit the unpublished draft and return actionable graph findings without mutation.

POST/developer/v1/workflows/{definition_id}/audit

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

definition_idrequired

stringpath

node_id

string | nullquery

Responses

200Successful Response

WorkflowAuditResponse

definition_idstring | null

editableboolean | null

errorstring | null

error_categorystring | null

filteredboolean | null

findingsarray<object<string, any>>

retryableboolean | null

runtime_notesarray<object<string, any>>

422Validation Error

HTTPValidationError

detailarray<ValidationError>

Request example

curl --request POST \
  --url 'https://api.umpa.genhealth.ai/developer/v1/workflows/{definition_id}/audit' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Accept: application/json'

Response example

{
  "definition_id": "string",
  "editable": true,
  "error": "string",
  "error_category": "string",
  "filtered": true,
  "findings": [
    {
      "example_key": "string"
    }
  ],
  "retryable": true,
  "runtime_notes": [
    {
      "example_key": "string"
    }
  ]
}

View OpenAPI document