API ReferenceWorkflows

Create workflow version

Create a new committed version from the current draft. Commit a version before deploying.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

workflow_idstringRequired
Workflow ID.

Request

This endpoint expects an object.
namestringOptional
descriptionstring or nullOptional
Optional version note or commit message.
typeenumOptional
Allowed values:
trigger_event_typestring or nullOptional
is_starredbooleanOptional
taskslist of maps from strings to anyOptional

Response

Workflow version created successfully

Errors

401
Unauthorized Error
404
Not Found Error