workflows

List workflow versions

List all draft and committed versions in a workflow family. An unknown family returns an empty page.

get/api/workflows/{workflow_id}/versions/

Path parameters

workflow_idstring required

Logical workflow-family ID.

Query parameters

pageinteger
page_sizeinteger
sort_bystring

Sort field, for example -updated_at.

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, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Response

Paginated workflow versions.

countinteger required
nextstring nullable required
previousstring nullable required
total_countinteger

Total count when available. This field can be omitted for API-key requests.

current_filtersobject

Changes