Get Workflow Details

Inspect before running

Using the example workflow server:

curl --fail-with-body http://127.0.0.1:7777/workflows/echo \
  -H "Authorization: Bearer $OS_SECURITY_KEY"

A regular workflow's details describe its steps and, when configured, its execution input_schema. Send a matching value in the execution request's message form field.

For a factory, this endpoint returns metadata without constructing the workflow. Its input_schema and factory_input_schema describe factory construction inputs. Pass those as the run request's factory_input JSON object, separately from message.

A registered code workflow takes precedence over a stored component with the same ID. version applies to stored configuration resolution. With authentication configured, explicit draft preview is limited to the owner or an administrator; an unavailable or forbidden preview can return 404. Unauthenticated open instances allow privileged preview.

GET/workflows/{workflow_id}

Retrieve detailed configuration and step information for a specific workflow.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

workflow_id*Workflow Id

Query Parameters

version?|

Workflow version to retrieve

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/workflows/string'
{  "id": "content-creation-workflow",  "name": "Content Creation Workflow",  "description": "Automated content creation from blog posts to social media",  "db_id": "123"}