---
title: "List workflow revision variables"
method: GET
path: "/workflows/{workflowId}/revisions/{revisionId}/variables"
tags: ["Workflow Revisions"]
---

# List workflow revision variables

`GET /workflows/{workflowId}/revisions/{revisionId}/variables`

Returns merge tag variables available in a workflow revision, filtered by type. Variables are returned in alphabetical order by label.

## Path parameters

- `workflowId` string, required
- `revisionId` string, required

## Query parameters

- `type` 'Standard' | 'FormField' | 'DataSet' | 'EmailTrigger' | 'DocumentReview', required — The kind of merge tag variable this is. - `Standard` — built-in variable like `{{workflow.name}}` or `{{run.startedDate}}`. - `FormField` — resolves to a form field value on the workflow run. - `DataSet` — resolves to a column from a linked data set row. - `EmailTrigger` — populated from an inbound email that triggered the workflow run. - `DocumentReview` — available on workflows using the Document Approvals feature.
- `_` string

## Response `200`

- PublicApiWorkflowRevisionVariableListResponse
  - `data` object[] — The list of resources returned by this request.
    - `key` string, required — Unique key used to identify this row across imports — matches the data set column referenced by the webhook's `keyColumn`.
    - `label` string, required — Display label shown to the end user.
    - `variableType` 'Standard' | 'FormField' | 'DataSet' | 'EmailTrigger' | 'DocumentReview', required — The kind of merge tag variable this is. - `Standard` — built-in variable like `{{workflow.name}}` or `{{run.startedDate}}`. - `FormField` — resolves to a form field value on the workflow run. - `DataSet` — resolves to a column from a linked data set row. - `EmailTrigger` — populated from an inbound email that triggered the workflow run. - `DocumentReview` — available on workflows using the Document Approvals feature (see https://www.process.st/help/docs/document-approvals/).
  - `links` object[] — Pagination links. When the result has more pages, look for an entry with `name: "next"` — its `href` is the URL to fetch the next page. Absence of `next` means there are no more pages. For single-resource responses this array is typically empty.
    - `name` string, required — Standard link relation name (RFC 5988) indicating this link's role. Common values include `self`, `edit`, `related`, `previous`, `next`.
    - `href` string, required — URL of the linked resource.
    - `rel` 'Approval Task' | 'Approvals' | 'Assignees' | 'Comment' | 'Data Set Records' | 'Data Sets' | 'Form Field Values' | 'Subject Task' | 'Task' | 'Tasks' | 'Users' | 'Webhook' | 'Workflow' | 'Workflow Run' — Optional. The kind of resource this link points to (e.g. `Workflow`, `Task`, `Comment`).
    - `type` 'Api' | 'App', required — Whether this link targets an API endpoint or a Process Street app URL. `Api` — a callable API endpoint you can fetch directly. `App` — a browser-facing URL in the Process Street UI.

## Other responses

- `400` — Invalid value for: query parameter type
- `default`

---

[API](https://skmtc.net/process/apis/process-street-public-api.md) · [All operations](https://skmtc.net/process/apis/process-street-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/process/process-street-public-api/revisions/6199a9464227/schema)