Rensei docs
API ReferenceWorkflows

List redacted model-profile launch options for one pinned workflow consumer input.

Human-authorized preview only. The request is pinned to workflow_versions.version and proves an explicit launchSelection edge when present. It does not admit, reserve, dispatch, or mutate a workflow.

GET
/api/workflows/{id}/versions/{version}/launch-options

Authorization

headerAuthorizationBearer <WorkOS user access token>

WorkOS user access token created by the Rensei CLI. The authenticated organization is resolved from membership and may be narrowed with X-Rensei-Org.

Path Parameters

id*string
version*string

Query Parameters

projectId*string
Length1 <= length
consumerNodeId*string
Length1 <= length
inputSlot*string
axis*string

Response Body

Visible model-profile candidates and graph evidence.

application/json
  1. response
contractVersion*string
consumer*
binding*|
options*array<>
readiness*string
Value in"ready""unknown""blocked"
unconsumedLaunchInputs*array<>
Example Request
curl -X GET 'https://app.rensei.ai/api/workflows/string/versions/string/launch-options?projectId=string&consumerNodeId=string&inputSlot=launchSelection&axis=executionSelection.modelProfile'
Example Response
{  "contractVersion": "rensei.workflow-launch-options/v1",  "consumer": {    "workflowId": "string",    "workflowVersion": 1,    "consumerNodeId": "string",    "inputSlot": "launchSelection",    "axis": "executionSelection.modelProfile"  },  "binding": {    "kind": "bound",    "edge": {      "id": "string",      "sourceNodeId": "string",      "sourceHandle": "launchSelection",      "targetNodeId": "string",      "targetHandle": "launchSelection"    },    "sourceProjection": "LaunchSelectionPortValue.executionSelection.modelProfile",    "selectionEvidence": {      "kind": "dynamic"    }  },  "options": [    {      "ref": {        "id": "string",        "revision": "string"      },      "label": "string",      "description": "string",      "status": "available",      "reason": "string",      "viability": {        "reason": "admission_pending",        "chip": "string",        "detail": "string",        "advisory": true      },      "meta": {        "property1": "string",        "property2": "string"      }    }  ],  "readiness": "ready",  "unconsumedLaunchInputs": [    {      "sourceNodeId": "string",      "sourceHandle": "launchSelection",      "reason": "No connected consumer reads this launch selection output."    }  ]}

Validate the current stored workflow without writing or executing it.

Checks one freshly authorized saved workflow snapshot under the existing project and Cedar edit-workflow decision. A valid result covers only the compiler checks represented by this endpoint; it does not establish publish, execution, or recipient readiness.

Restore a workflow version while validating its inbound webhook mapping.

Restore a workflow version while validating its inbound webhook mapping. - Rensei REST API operation reference.