Get Workflow Schema

GET /workflows/{workflow_id}/{version}/schema

X-API-Key: ca_your_api_key_here

{
  "workflow_schema": {
    "workflow_id": "vendor_contract_review",
    "workflow_name": "Vendor Contract Review",
    "version": 1,
    "description": "Review and approve vendor contracts with automated checks",
    "is_active": true,
    "variables": [
      {
        "variable_id": "contract_file",
        "variable_name": "Contract Document",
        "type": "file",
        "required": true,
        "description": "The vendor contract to review",
        "validation": {
          "allowed_extensions": ["pdf", "docx"]
        }
      },
      {
        "variable_id": "vendor_name",
        "variable_name": "Vendor Name",
        "type": "text",
        "required": true,
        "description": "Name of the vendor"
      },
      {
        "variable_id": "contract_value",
        "variable_name": "Contract Value",
        "type": "number",
        "required": true,
        "description": "Total contract value in USD"
      },
      {
        "variable_id": "reviewer_email",
        "variable_name": "Reviewer",
        "type": "email",
        "required": true,
        "description": "Email of the person who will review"
      }
    ],
    "steps": [
      {
        "step_id": "intake_step",
        "step_name": "Collect Contract Details",
        "step_type": "intake",
        "description": "Collect contract and vendor information"
      },
      {
        "step_id": "review_step",
        "step_name": "AI Review",
        "step_type": "agent",
        "description": "AI analyzes contract for risks and compliance"
      },
      {
        "step_id": "approval_step",
        "step_name": "Manager Approval",
        "step_type": "approval",
        "description": "Manager reviews and approves or rejects"
      }
    ]
  }
}

{
  "detail": "Invalid version format: invalid_version"
}

{
  "detail": "Invalid API key"
}

{
  "detail": "Workflow not found"
}

{
  "detail": "Failed to get workflow schema"
}