---
title: "List all form field values in a task"
method: GET
path: "/workflow-runs/{workflowRunId}/tasks/{taskId}/form-fields"
tags: ["Form Field Values"]
---

# List all form field values in a task

`GET /workflow-runs/{workflowRunId}/tasks/{taskId}/form-fields`

Gets a page of form field values for a task of a workflow run.
Form field values are paged, meaning the links section in the
response must be used to get the next/previous batch of form field values.

## Path parameters

- `workflowRunId` string, required
- `taskId` string, required

## Query parameters

- `_` string

## Response `200`

- ListFormFieldValuesResponse
  - `fields` object[] — Form field definitions or column definitions, depending on context.
    - `id` string, required — The resource's ID.
    - `updatedDate` string, date-time — When the resource was last modified. ISO-8601 UTC.
    - `updatedBy` object — User who last modified the resource.
      - `id` string, required — The resource's ID.
      - `email` string, required — The user's email address (also their login identifier).
      - `username` string, required — The user's display name (e.g. `Jane Doe`).
    - `workflowRunId` string, required — The ID of the Workflow Run.
    - `taskId` string, required — The ID of the Task.
    - `key` string, required — Unique key based on the label. This is used when referencing the form field as a [variable](https://www.process.st/help/docs/variables/)
    - `label` string — User defined label
    - `data` unknown, required
    - `fieldType` 'Date' | 'Document' | 'Email' | 'File' | 'Hidden' | 'Members' | 'MultiChoice' | 'MultiFile' | 'MultiSelect' | 'Number' | 'Select' | 'SendRichEmail' | 'Snippet' | 'Table' | 'Text' | 'Textarea' | 'Url', required — Form-field subtype discriminator (only relevant when widget `type` is `FormField`). - `Text` — short text input (≤255 characters). - `Textarea` — long-form text. - `Email` — email address. - `Url` — website / URL. - `Number` — numeric input with optional unit and constraints. - `Date` — date or date+time picker. - `Select` — dropdown; user picks one option. - `MultiChoice` — checkboxes; user picks one or more options. - `MultiSelect` — Subtasks: a checklist of sub-items inside the task. - `Members` — assignee picker (selects organization users). - `File` — single file upload. - `MultiFile` — multi-file upload (in-app "File Upload"). - `Document` — document approval field; links the task to a document review. - `Table` — rows × columns of cells; users fill cell values. - `SendRichEmail` — pre-written email embedded in the task; sent manually by the user or automatically when the task is completed. - `Hidden` — only visible when editing the workflow; populated by integrations or default values. - `Snippet` — only visible when editing; passes static text or merge tags into automations.
    - `dataSetLinked` boolean — When `true`, this field is bound to a data set row; its value is synchronised from the linked record.
    - `links` object[] — Navigable HATEOAS links to related resources. Each entry has a `name` (RFC-5988 relation), an `href` URL, and a `type` (`Api` or `App`).
      - `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.
  - `links` object[] — Navigable HATEOAS links to related resources. Each entry has a `name` (RFC-5988 relation), an `href` URL, and a `type` (`Api` or `App`).
    - `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

- `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)