Deploy workflow version

POST

https://api.respan.ai/api/workflows/:workflow_id/deployments/

Deploy a committed workflow version. Sets the target version as live and disables all other versions.

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.

versionintegerOptional

Version number to deploy. If omitted, the latest committed version is deployed.

Response

Workflow deployed successfully

idstring

workflow_idstring

versioninteger

is_enabledboolean

is_read_onlyboolean

Errors

401

Unauthorized Error

404

Not Found Error

$	curl -X POST https://api.respan.ai/api/workflows/workflow_id/deployments/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"version": 3
>	}'

1	{
2	"id": "wv_12345",
3	"workflow_id": "wf_analytics_2024",
4	"version": 3,
5	"is_enabled": true,
6	"is_read_only": true
7	}