workflows

Update latest workflow draft

Update the latest editable (draft) workflow version. Only the draft version can be edited.

patch/api/workflows/{workflow_id}/

Path parameters

workflow_idstring required

Workflow ID.

Headers

Authorizationstring required

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.

Request body

namestring
descriptionstring nullable
type'automations' | 'monitors' | 'evaluators'
trigger_event_type'request_log' | 'trace_completed' | 'customer_budget_limit_reached' | 'credit_low_balance_threshold_reached' | 'on_eval_result_ingested' | 'custom_event' | 'eval_only'
is_starredboolean
tasksobject[]

Response

Workflow updated successfully

object required

Changes