Get Workflow Schema

Endpoint

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

Authentication

This endpoint requires an OAuth access token. Send it as a bearer token:

Authorization: Bearer your_access_token

Required scope: workflows:read

Path Parameters

Parameter	Type	Required	Description
`workflow_id`	string	Yes	Unique identifier for the workflow
`version`	string	Yes	Version number (e.g., “1”) or “latest” for the most recent version

Request Example

curl -X GET "https://platform.chamelio.ai/v2/workflows/vendor_contract_review/latest/schema" \
  -H "Authorization: Bearer your_access_token"

import requests

workflow_id = "vendor_contract_review"
version = "latest"

url = f"https://platform.chamelio.ai/v2/workflows/{workflow_id}/{version}/schema"
headers = {
    "Authorization": "Bearer your_access_token"
}

response = requests.get(url, headers=headers)
print(response.json())

const workflowId = 'vendor_contract_review';
const version = 'latest';

const response = await fetch(
  `https://platform.chamelio.ai/v2/workflows/${workflowId}/${version}/schema`,
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer your_access_token'
    }
  }
);

const data = await response.json();
console.log(data);

Response

Success Response

Status Code: 200 OK

{
  "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"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`workflow_schema`	object	Complete workflow schema including all variables and steps

Workflow Schema Object

Field	Type	Description
`workflow_id`	string	Unique identifier for the workflow
`workflow_name`	string	Human-readable workflow name
`version`	integer	Workflow version number
`description`	string	Description of what the workflow does
`is_active`	boolean	Whether the workflow is currently active
`variables`	array	List of input variables with validation rules
`steps`	array	List of workflow steps in execution order

Variable Object Fields

Field	Type	Description
`variable_id`	string	Unique identifier for the variable
`variable_name`	string	Human-readable variable name
`type`	string	Variable type: `text`, `number`, `boolean`, `date`, `email`, `select`, `file`, `user_entity`, `business`
`required`	boolean	Whether the variable is required for workflow initiation
`description`	string	Description of what the variable represents
`validation`	object	Optional validation rules (e.g., allowed file extensions, value ranges)

Error Responses

400 Bad Request

Returned when the version format is invalid, or when the access token has no user behind it. client_credentials tokens act as the admin who created the application, so this applies only to tokens issued before application creators were recorded.

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

{
  "detail": "client_credentials tokens are not associated with a user"
}

401 Unauthorized

Returned when the access token is missing, unknown, revoked, or expired, or when an X-API-Key was sent instead of a bearer token. See OAuth error responses.

{
  "detail": "Invalid access token"
}

403 Forbidden

Returned when the token lacks the required scope:

{
  "detail": "Insufficient scope; this endpoint requires: workflows:read"
}

Or when the user may not access this workflow:

{
  "detail": "You do not have access to this resource"
}

404 Not Found

Returned when the workflow or version does not exist.

{
  "detail": "Not found"
}

429 Too Many Requests

Returned when your organization exceeds its per-minute request limit.

{
  "detail": "Rate limit exceeded"
}

500 Internal Server Error

Returned when the request fails due to a server error.

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

Notes

Use "latest" as the version to always get the most recent workflow schema without tracking version numbers.

The schema is fetched as the access token’s user. A workflow the user cannot reach returns 403 rather than a schema.

Variable types and validation rules must be respected when initiating workflows. Validation failures result in a 422 error.

Use Cases

This endpoint is useful for:

Form generation - Dynamically create input forms based on workflow variables
Validation - Validate user input before initiating workflows
Documentation - Display workflow requirements to users
Integration planning - Understand what data is needed to start a workflow

Overview

API Key Access

OAuth App Access

Webhooks

Endpoint

Authentication

Path Parameters

Request Example

Response

Success Response

Response Fields

Workflow Schema Object

Variable Object Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

429 Too Many Requests

500 Internal Server Error

Notes

Use Cases

​Endpoint

​Authentication

​Path Parameters

​Request Example

​Response

​Success Response

​Response Fields

​Workflow Schema Object

​Variable Object Fields

​Error Responses

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

​429 Too Many Requests

​500 Internal Server Error

​Notes

​Use Cases

Endpoint

Authentication

Path Parameters

Request Example

Response

Success Response

Response Fields

Workflow Schema Object

Variable Object Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

429 Too Many Requests

500 Internal Server Error

Notes

Use Cases