workflows

List all Workflow Versions

Retrieves the published versions and current draft version of a Workflow. Archived versions are not returned.

Provide the Workflow ID in filter[workflow-id], which you can copy from the Workflow in your Persona dashboard. The live, rollout-label, and rollout-percentage attributes are relative to the environment your API key belongs to: a version live in Production is not live in Sandbox. Sandbox API keys are supported, and report live: false for every version of a Workflow that is only deployed to Production.

get/workflow-versions

Request

  • Base URL: https://api.withpersona.com/api/v1
  • URL: https://api.withpersona.com/api/v1/workflow-versions
  • Auth: HTTP bearer

Query parameters

afterstring

Object ID for pagination cursor

beforestring

Object ID for pagination cursor

sizenumber double

Limit on the number of objects returned

fieldsobject

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See Serialization for more details.

workflow-idstring required

The Workflow ID to list versions for.

Headers

Key-Inflection'camel' | 'kebab' | 'snake'

Determines casing for the API response.

Idempotency-Keystring

Ensures the request is idempotent.

Persona-Version'2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18'

Server API version. More info on versioning can be found here.

Response

This endpoint returns a collection of Workflow Version objects.

Changes

No recorded changes to this operation across all 1 revision of this API.