---
title: "Upload a file to a page widget"
method: POST
path: "/pages/{pageId}/revisions/{revisionId}/widgets/{widgetId}/upload"
tags: ["Page Widgets"]
---

# Upload a file to a page widget

`POST /pages/{pageId}/revisions/{revisionId}/widgets/{widgetId}/upload`

Uploads a file to an Image or File widget on a draft page revision. Replaces the existing file, if any.

Accepts multipart form data (field `file`) or JSON with base64-encoded content (field `fileBase64`).
Maximum file size: 20 MB for multipart, 10 MB for base64.
You can also send JSON `{ "fileUploadId": "..." }` to attach a file you uploaded with
`createFileUpload`; the `fileUploadId` is single-use.
For Image widgets, only image/* content types are accepted.

## Path parameters

- `pageId` string, required
- `revisionId` string, required
- `widgetId` string, required

## Request body

- UploadWidgetFileRequest
  - `file` string, binary — Uploaded file reference. Use the upload endpoint to attach content.
  - `fileBase64` object
    - `content` string, required — Rich text content. May contain merge tags.
    - `filename` string, required
  - `fileUploadId` string

## Response `200`

- PublicApiWidgetResponse
  - `data` union, required
    - object
      - `hiddenByDefault` boolean, required — When `true`, the widget is hidden by default; conditional logic rules can reveal it at runtime. Defaults to `false`.
      - `id` string, required — The ID of the Widget
      - `taskId` string, required — The ID of the Task
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created 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`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — 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`).
      - `linkedTemplateId` string — The ID of the linked workflow or page that this CrossLink widget points to.
      - `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.
      - `type` 'FormField' | 'Text' | 'Image' | 'File' | 'Video' | 'Embed' | 'CrossLink', required — Widget kind discriminator. - `FormField` — collects user input (Text, Number, Date, etc. — see `fieldType`). - `Text` — rich text content displayed on the task. - `Image` — image content displayed on the task. - `File` — downloadable file attached to the task. - `Video` — video content (uploaded or linked from a hosting service). - `Embed` — embedded external content via URL. - `CrossLink` — link to another workflow or page.
    - object
      - `hiddenByDefault` boolean, required — When `true`, the widget is hidden by default; conditional logic rules can reveal it at runtime. Defaults to `false`.
      - `id` string, required — The ID of the Widget
      - `taskId` string, required — The ID of the Task
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created 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`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — 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`).
      - `url` string — Target URL.
      - `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.
      - `type` 'FormField' | 'Text' | 'Image' | 'File' | 'Video' | 'Embed' | 'CrossLink', required — Widget kind discriminator. - `FormField` — collects user input (Text, Number, Date, etc. — see `fieldType`). - `Text` — rich text content displayed on the task. - `Image` — image content displayed on the task. - `File` — downloadable file attached to the task. - `Video` — video content (uploaded or linked from a hosting service). - `Embed` — embedded external content via URL. - `CrossLink` — link to another workflow or page.
    - object
      - `hiddenByDefault` boolean, required — When `true`, the widget is hidden by default; conditional logic rules can reveal it at runtime. Defaults to `false`.
      - `id` string, required — The ID of the Widget
      - `taskId` string, required — The ID of the Task
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created 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`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — 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`).
      - `description` string — Optional long-form description.
      - `file` object — Uploaded file reference. Use the upload endpoint to attach content.
        - `id` string, required — The resource's ID.
        - `name` string, required — Display name.
        - `mimeType` string, required — MIME type detected at upload time (e.g. `image/png`, `application/pdf`).
        - `size` integer, required — File size in bytes.
      - `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.
      - `type` 'FormField' | 'Text' | 'Image' | 'File' | 'Video' | 'Embed' | 'CrossLink', required — Widget kind discriminator. - `FormField` — collects user input (Text, Number, Date, etc. — see `fieldType`). - `Text` — rich text content displayed on the task. - `Image` — image content displayed on the task. - `File` — downloadable file attached to the task. - `Video` — video content (uploaded or linked from a hosting service). - `Embed` — embedded external content via URL. - `CrossLink` — link to another workflow or page.
    - object
      - `hiddenByDefault` boolean, required — When `true`, the widget is hidden by default; conditional logic rules can reveal it at runtime. Defaults to `false`.
      - `id` string, required — The ID of the Widget
      - `taskId` string, required — The ID of the Task
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created 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`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — 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`).
      - `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.
      - `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 — Display label shown to the end user.
      - `required` boolean, required — When `true`, the form field must have a value before its task can be completed.
      - `config` union, required — Field-specific configuration. Shape depends on `fieldType`.
        - object
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `timeOption` 'Included' | 'Excluded' | 'Optional' — How time-of-day is handled on this Date field. - `Included` — the field always captures both date and time. - `Excluded` — date only; time is never captured. - `Optional` — the user picks whether to include a time.
          - `fieldType` 'Date', 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.
        - object
          - `reviewRequest` boolean, required — When `true`, the email requires explicit user review/send rather than auto-send.
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `fieldType` 'Document', 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.
        - object
          - `placeholder` string — Placeholder hint shown in the input when no value has been entered.
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `fieldType` 'Email', 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.
        - object
          - `placeholder` string — Placeholder hint shown in the input when no value has been entered.
          - `extractTextContent` boolean — When `true`, server extracts text from uploaded documents for use in merge tags.
          - `fieldType` 'File', 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.
        - object
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `fieldType` 'Hidden', 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.
        - object
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `groupId` string — The ID of an organization group.
          - `fieldType` 'Members', 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.
        - object
          - `items` object[] — Available options for selection-style form fields.
            - `id` string — The resource's ID.
            - `name` string, required — Display name.
          - `fieldType` 'MultiChoice', 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.
        - object
          - `placeholder` string — Placeholder hint shown in the input when no value has been entered.
          - `extractTextContent` boolean — When `true`, server extracts text from uploaded documents for use in merge tags.
          - `fieldType` 'MultiFile', 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.
        - object
          - `items` object[] — Available options for selection-style form fields.
            - `id` string — The resource's ID.
            - `name` string, required — Display name.
          - `fieldType` 'MultiSelect', 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.
        - object
          - `placeholder` string — Placeholder hint shown in the input when no value has been entered.
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `unit` string — Unit label rendered next to the numeric value (e.g. `kg`, `$`, `%`).
          - `unitLocation` 'prefix' | 'suffix' — Where the unit symbol appears relative to the number. - `prefix` — before the number (e.g. `$100`). - `suffix` — after the number (e.g. `100 USD`).
          - `fieldType` 'Number', 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.
        - object
          - `items` object[] — Available options for selection-style form fields.
            - `id` string — The resource's ID.
            - `name` string, required — Display name.
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `fieldType` 'Select', 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.
        - object
          - `to` string[] — Default recipient list (To). Comma-separated email addresses or merge tags.
          - `cc` string[] — Default CC list. Comma-separated email addresses or merge tags.
          - `bcc` string[] — Default BCC list. Comma-separated email addresses or merge tags.
          - `replyTo` string[] — Default Reply-To address. An email address or merge tag.
          - `subject` string — Default email subject. May contain merge tags.
          - `body` string — Default email body. May contain merge tags.
          - `bodyEditor` 'RichText' | 'HTML' | 'PlainText', required — Editor used to author the email body. - `RichText` — rich-text editor with formatting. - `HTML` — raw HTML editor. - `PlainText` — plain text editor.
          - `editAllowed` boolean — When `true`, users running the workflow can edit the email before sending.
          - `fieldType` 'SendRichEmail', 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.
        - object
          - `value` string — The option's stored value.
          - `fieldType` 'Snippet', 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.
        - object
          - `columnDefs` object[] — Data set column definitions (name + type per column).
            - `id` string, required — The resource's ID.
            - `name` string, required — Display name.
            - `columnType` 'Text', required — Data type a Table column accepts. - `Text` — free-form short text.
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `fieldType` 'Table', 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.
        - object
          - `placeholder` string — Placeholder hint shown in the input when no value has been entered.
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `fieldType` 'Text', 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.
        - object
          - `placeholder` string — Placeholder hint shown in the input when no value has been entered.
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `format` 'PlainText' | 'RichText' — Editor style for this Textarea field. - `PlainText` — plain text. - `RichText` — rich-text editor with formatting (bold, lists, links, etc.).
          - `fieldType` 'Textarea', 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.
        - object
          - `defaultValue` string — Default value pre-filled when a new workflow run is created.
          - `fieldType` '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.
      - `constraints` union — Field-specific validation constraints. Shape depends on `fieldType`.
        - object
          - `afterDate` string, date-time — Earliest accepted date (inclusive). Pair with `afterDateSourceType`.
          - `beforeDate` string, date-time — Latest accepted date (inclusive). Pair with `beforeDateSourceType`.
          - `afterDateFormFieldWidgetGroupId` string — When `afterDateSourceType=FormField`, the ID of the Date form field whose value is the lower bound.
          - `beforeDateFormFieldWidgetGroupId` string — When `beforeDateSourceType=FormField`, the ID of the Date form field whose value is the upper bound.
          - `afterDateSourceType` 'SpecificDate' | 'FormFieldValue' | 'TaskDueDate' | 'ChecklistStartDate' | 'ChecklistDueDate' — How the before/after constraint date is derived. - `SpecificDate` — an absolute date supplied as `afterDate` / `beforeDate`. - `FormFieldValue` — derived from another Date form field (`afterDateField` / `beforeDateField`). - `TaskDueDate` — relative to the containing task's due date. - `ChecklistStartDate` / `ChecklistDueDate` — relative to the workflow run's start or due date.
          - `beforeDateSourceType` 'SpecificDate' | 'FormFieldValue' | 'TaskDueDate' | 'ChecklistStartDate' | 'ChecklistDueDate' — How the before/after constraint date is derived. - `SpecificDate` — an absolute date supplied as `afterDate` / `beforeDate`. - `FormFieldValue` — derived from another Date form field (`afterDateField` / `beforeDateField`). - `TaskDueDate` — relative to the containing task's due date. - `ChecklistStartDate` / `ChecklistDueDate` — relative to the workflow run's start or due date.
          - `afterDateOffset` string — ISO 8601 duration (e.g. `P7D`, `P1Y2M`).
          - `beforeDateOffset` string — ISO 8601 duration (e.g. `P7D`, `P1Y2M`).
          - `fieldType` 'Date', 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.
        - object
          - `domains` string[] — Allowed (or blocked, depending on `restriction`) email domains for this field.
          - `restriction` 'Allow' | 'Block' — How the `domains` list filters allowed email addresses. - `Allow` — only emails whose domain is in the list are accepted. - `Block` — emails whose domain is in the list are rejected; all others accepted.
          - `fieldType` 'Email', 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.
        - object
          - `extensions` string[] — Allowed file extensions, including the leading dot (e.g. `.pdf`, `.docx`).
          - `fieldType` 'File', 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.
        - object
          - `extensions` string[] — Allowed file extensions, including the leading dot (e.g. `.pdf`, `.docx`).
          - `mode` 'Multiple' | 'Single' — Whether the field accepts a single file or multiple files. - `Single` — only one file may be uploaded. - `Multiple` — multiple files may be uploaded.
          - `fieldType` 'MultiFile', 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.
        - object
          - `minDigits` integer — Minimum number of digits.
          - `maxDigits` integer — Maximum number of digits.
          - `minValue` integer — Minimum numeric value.
          - `maxValue` integer — Maximum numeric value.
          - `decimalPlaces` integer — Number of decimal places to accept (0 means integers only).
          - `allowNegative` boolean — When `true`, negative numbers are accepted.
          - `fieldType` 'Number', 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.
        - object
          - `min` integer — Inclusive lower bound.
          - `max` integer — Inclusive upper bound.
          - `fieldType` 'Text', 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.
        - object
          - `min` integer — Inclusive lower bound.
          - `max` integer — Inclusive upper bound.
          - `fieldType` 'Textarea', 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.
      - `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.
      - `type` 'FormField' | 'Text' | 'Image' | 'File' | 'Video' | 'Embed' | 'CrossLink', required — Widget kind discriminator. - `FormField` — collects user input (Text, Number, Date, etc. — see `fieldType`). - `Text` — rich text content displayed on the task. - `Image` — image content displayed on the task. - `File` — downloadable file attached to the task. - `Video` — video content (uploaded or linked from a hosting service). - `Embed` — embedded external content via URL. - `CrossLink` — link to another workflow or page.
    - object
      - `hiddenByDefault` boolean, required — When `true`, the widget is hidden by default; conditional logic rules can reveal it at runtime. Defaults to `false`.
      - `id` string, required — The ID of the Widget
      - `taskId` string, required — The ID of the Task
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created 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`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — 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`).
      - `caption` string — Caption text rendered with the image.
      - `file` object — Uploaded file reference. Use the upload endpoint to attach content.
        - `id` string, required — The resource's ID.
        - `name` string, required — Display name.
        - `mimeType` string, required — MIME type detected at upload time (e.g. `image/png`, `application/pdf`).
        - `size` integer, required — File size in bytes.
      - `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.
      - `type` 'FormField' | 'Text' | 'Image' | 'File' | 'Video' | 'Embed' | 'CrossLink', required — Widget kind discriminator. - `FormField` — collects user input (Text, Number, Date, etc. — see `fieldType`). - `Text` — rich text content displayed on the task. - `Image` — image content displayed on the task. - `File` — downloadable file attached to the task. - `Video` — video content (uploaded or linked from a hosting service). - `Embed` — embedded external content via URL. - `CrossLink` — link to another workflow or page.
    - object
      - `hiddenByDefault` boolean, required — When `true`, the widget is hidden by default; conditional logic rules can reveal it at runtime. Defaults to `false`.
      - `id` string, required — The ID of the Widget
      - `taskId` string, required — The ID of the Task
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created 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`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — 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`).
      - `content` string — Rich text content. May contain merge tags.
      - `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.
      - `type` 'FormField' | 'Text' | 'Image' | 'File' | 'Video' | 'Embed' | 'CrossLink', required — Widget kind discriminator. - `FormField` — collects user input (Text, Number, Date, etc. — see `fieldType`). - `Text` — rich text content displayed on the task. - `Image` — image content displayed on the task. - `File` — downloadable file attached to the task. - `Video` — video content (uploaded or linked from a hosting service). - `Embed` — embedded external content via URL. - `CrossLink` — link to another workflow or page.
    - object
      - `hiddenByDefault` boolean, required — When `true`, the widget is hidden by default; conditional logic rules can reveal it at runtime. Defaults to `false`.
      - `id` string, required — The ID of the Widget
      - `taskId` string, required — The ID of the Task
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created 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`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — 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`).
      - `description` string — Optional long-form description.
      - `url` string — Target URL.
      - `file` object — Uploaded file reference. Use the upload endpoint to attach content.
        - `id` string, required — The resource's ID.
        - `name` string, required — Display name.
        - `mimeType` string, required — MIME type detected at upload time (e.g. `image/png`, `application/pdf`).
        - `size` integer, required — File size in bytes.
      - `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.
      - `type` 'FormField' | 'Text' | 'Image' | 'File' | 'Video' | 'Embed' | 'CrossLink', required — Widget kind discriminator. - `FormField` — collects user input (Text, Number, Date, etc. — see `fieldType`). - `Text` — rich text content displayed on the task. - `Image` — image content displayed on the task. - `File` — downloadable file attached to the task. - `Video` — video content (uploaded or linked from a hosting service). - `Embed` — embedded external content via URL. - `CrossLink` — link to another workflow or page.
  - `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
- `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)
