Workflow Developer API

Get Workflow Graph

Read the complete public-safe graph for a workflow's current target version.

GET/developer/v1/workflows/{definition_id}/graph

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

Responses

200Successful Response

WorkflowGraphResponse

definition_idstring | null

edge_countinteger | null

edgesarray<WorkflowEdgeSchema>

editableboolean | null

errorstring | null

error_categorystring | null

node_countinteger | null

nodesarray<WorkflowNodeSchema>

422Validation Error

HTTPValidationError

detailarray<ValidationError>

Request example

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

Response example

{
  "definition_id": "string",
  "edge_count": 1,
  "edges": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_node_id": "string",
      "source_output": "default",
      "target_input": "default",
      "target_node_id": "string"
    }
  ],
  "editable": true,
  "error": "string",
  "error_category": "string",
  "node_count": 1,
  "nodes": [
    {
      "config": {
        "example_key": "string"
      },
      "default_value": {
        "example_key": "string"
      },
      "error_strategy": "fail",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "string",
      "position": [
        1
      ],
      "retry_config": {
        "example_key": "string"
      },
      "type": "string"
    }
  ]
}

View OpenAPI document