---
title: "partially update many existing task"
method: PATCH
path: "/api/servicetodo/tasks"
tags: ["tasks"]
---

# partially update many existing task

`PATCH /api/servicetodo/tasks`

Partially update many existing task

## Request body

- Task[]
  - `uuid` string, uuid
  - `createdAt` string, date-time
  - `createdBy` string, uuid
  - `lastUpdatedAt` string, date-time
  - `lastUpdatedBy` string, uuid
  - `lastUpdatedByAudience` string
  - `lastUpdatedByAudienceUuid` string, uuid
  - `lastUpdatedByImpersonatedBy` string, uuid
  - `lastUpdatedByCompanyUuid` string, uuid
  - `lastUpdatedByEnterpriseUuid` string, uuid
  - `companyUuid` string, uuid, required
  - `title` string, required
  - `description` string
  - `taskType` 'dataCollection' | 'informationSharing' | 'training' | 'backgroundCheck' | 'tinCheck' | 'i9' | 'w4' | 'documentSigning' | 'universal' | 'partnerTask' | 'video' | 'internalDataReview' | 'internalExternalAction' | 'compliance', required
  - `subType` 'default' | 'iframe' | 'webhook' | 'workato' | 'youtube'
  - `estimatedCompletionMinutes` number
  - `content` object
    - `buttonLabel` string
    - `text` string
    - `attachments` object[] — Optional list of file attachments associated with an information-sharing task. Files are stored in service-media under the ATTACHMENTS storage folder and referenced here by UUID.
      - `storedFileUuid` string, uuid, required
      - `filename` string, required
      - `mimeType` string, required
    - `uuid` string
    - `title` string
    - `subtitle` string
    - `description` string
    - `inputs` object[]
      - `uuid` string
      - `title` string
      - `subtitle` string
      - `description` string
      - `inputType` 'string' | 'select' | 'media' | 'date' | 'number' | 'address' | 'bankAcctNumber' | 'bankRoutingNumber' | 'phone' | 'email'
      - `required` boolean
      - `items` object[]
        - `label` string
        - `value` string
      - `style` 'select' | 'multiSelect' | 'checkbox' | 'radio' | 'default' | 'textarea'
      - `config` object
        - `minSelect` number
        - `maxSelect` number
        - `minValue` number
        - `maxValue` number
        - `hasMaxLength` boolean
        - `minLength` number
        - `maxLength` number
        - `placeholder` string
        - `datePast` boolean
        - `dateFuture` boolean
      - `customAttribute` object
        - `label` string
        - `uuid` string, required
        - `key` string
    - `options` object
    - `signDoc` object, nullable
      - `uuid` string, uuid
      - `createdAt` string, date-time
      - `createdBy` string, uuid
      - `lastUpdatedAt` string, date-time
      - `lastUpdatedBy` string, uuid
      - `lastUpdatedByAudience` string
      - `lastUpdatedByAudienceUuid` string, uuid
      - `lastUpdatedByImpersonatedBy` string, uuid
      - `lastUpdatedByCompanyUuid` string, uuid
      - `lastUpdatedByEnterpriseUuid` string, uuid
      - `name` string, required
      - `technicalName` string
      - `fileUrls` string[]
      - `mergeKeys` string[]
      - `templateId` string
      - `editEmbedUrl` string
      - `companyUuid` string, uuid
      - `technical` boolean
      - `counterSignEnabled` boolean
      - `coSignerRequired` boolean
      - `coSignerEmailCustomAttributeKey` string
      - `editUrl` string — Edit URL for embedded templates created via templateCreateEmbeddedDraft
      - `editUrlExpiresAt` number — Expiration timestamp (milliseconds) for the editUrl. Used to determine if editUrl is still valid.
    - `signDocUuid` string
    - `section2CompletionMethods` object[]
      - `methodName` 'authorizedRepresentative' | 'adminValidation' | 'onSiteVerification' | 'liveVideoVerification', required
      - `requiredDuration` number
      - `calendarGroupUuid` string
      - `eventDescription` string
      - `recommended` boolean
      - `reminder` number
      - `customConferencingEnabled` boolean
      - `customConferencing` object
        - `providerDescription` string
        - `joinUrl` string, url
    - `url` string
    - `bgcProvider` string
    - `bgcPackage` string
    - `tinProvider` string
    - `endEvent` string
    - `hideCompletedButton` boolean
    - `appendWxQueryParams` boolean
    - `sensitiveData` boolean
    - `useI9C2PayloadFormat` boolean
    - `triggerableType` 'flow' | 'task'
    - `triggerableTaskUuid` string
    - `companyAttributeSetUuid` string
    - `companyAttributeSet` object, nullable
      - `uuid` string, uuid
      - `createdAt` string, date-time
      - `createdBy` string, uuid
      - `lastUpdatedAt` string, date-time
      - `lastUpdatedBy` string, uuid
      - `lastUpdatedByAudience` string
      - `lastUpdatedByAudienceUuid` string, uuid
      - `lastUpdatedByImpersonatedBy` string, uuid
      - `lastUpdatedByCompanyUuid` string, uuid
      - `lastUpdatedByEnterpriseUuid` string, uuid
      - `companyUuid` string, required
      - `label` string, required
      - `description` string
      - `companyAttributes` object[]
        - `companyAttributeUuid` string
        - `value` union
          - string
          - string[]
          - number
          - boolean
          - object
            - `address` string
            - `address2` string
            - `city` string
            - `state` string
            - `zip` string
            - `country` string
        - `companyAttribute` object
          - `uuid` string, uuid
          - `createdAt` string, date-time
          - `createdBy` string, uuid
          - `lastUpdatedAt` string, date-time
          - `lastUpdatedBy` string, uuid
          - `lastUpdatedByAudience` string
          - `lastUpdatedByAudienceUuid` string, uuid
          - `lastUpdatedByImpersonatedBy` string, uuid
          - `lastUpdatedByCompanyUuid` string, uuid
          - `lastUpdatedByEnterpriseUuid` string, uuid
          - `label` string
          - `key` string
          - `dataType` 'string' | 'number' | 'date' | 'boolean' | 'select' | 'address' | 'media' | 'signature' | 'complianceDocument'
          - `description` string
          - `options` object[]
            - `value` string, required
            - `label` string
          - `hireUuid` string, uuid
          - `readOnly` boolean
          - `attachedToModel` 'location' | 'locationGroup' | 'job' | 'opening'
      - `attachedTo` object
        - `model` 'location' | 'locationGroup' | 'job' | 'opening'
        - `uuid` string
    - `customAttribute` object
      - `label` string
      - `uuid` string, required
      - `key` string
    - `instructionNotes` string
    - `attributesToReview` string[]
    - `requirementUuid` string, uuid — UUID of the compliance requirement from service-compliancev2
  - `requireReview` boolean
  - `reuseInRehire` boolean — When true (default), the task completion is carried over to the rehire profile. When false, the task starts incomplete in the rehire profile. Ignored for I-9, W-4, Background Check, and TIN Check tasks (always start incomplete).
  - `isInternal` boolean
  - `internalTaskData` object
    - `employerUuids` string[]
    - `trigger` object
      - `type` string
      - `taskUuid` string

## Response `202`

tasks updated. Wrapped in a JsonAPI root response.

- object
  - `data` Task[]
    - `uuid` string, uuid
    - `createdAt` string, date-time
    - `createdBy` string, uuid
    - `lastUpdatedAt` string, date-time
    - `lastUpdatedBy` string, uuid
    - `lastUpdatedByAudience` string
    - `lastUpdatedByAudienceUuid` string, uuid
    - `lastUpdatedByImpersonatedBy` string, uuid
    - `lastUpdatedByCompanyUuid` string, uuid
    - `lastUpdatedByEnterpriseUuid` string, uuid
    - `companyUuid` string, uuid, required
    - `title` string, required
    - `description` string
    - `taskType` 'dataCollection' | 'informationSharing' | 'training' | 'backgroundCheck' | 'tinCheck' | 'i9' | 'w4' | 'documentSigning' | 'universal' | 'partnerTask' | 'video' | 'internalDataReview' | 'internalExternalAction' | 'compliance', required
    - `subType` 'default' | 'iframe' | 'webhook' | 'workato' | 'youtube'
    - `estimatedCompletionMinutes` number
    - `content` object
      - `buttonLabel` string
      - `text` string
      - `attachments` object[] — Optional list of file attachments associated with an information-sharing task. Files are stored in service-media under the ATTACHMENTS storage folder and referenced here by UUID.
        - `storedFileUuid` string, uuid, required
        - `filename` string, required
        - `mimeType` string, required
      - `uuid` string
      - `title` string
      - `subtitle` string
      - `description` string
      - `inputs` object[]
        - `uuid` string
        - `title` string
        - `subtitle` string
        - `description` string
        - `inputType` 'string' | 'select' | 'media' | 'date' | 'number' | 'address' | 'bankAcctNumber' | 'bankRoutingNumber' | 'phone' | 'email'
        - `required` boolean
        - `items` object[]
          - `label` string
          - `value` string
        - `style` 'select' | 'multiSelect' | 'checkbox' | 'radio' | 'default' | 'textarea'
        - `config` object
          - `minSelect` number
          - `maxSelect` number
          - `minValue` number
          - `maxValue` number
          - `hasMaxLength` boolean
          - `minLength` number
          - `maxLength` number
          - `placeholder` string
          - `datePast` boolean
          - `dateFuture` boolean
        - `customAttribute` object
          - `label` string
          - `uuid` string, required
          - `key` string
      - `options` object
      - `signDoc` object, nullable
        - `uuid` string, uuid
        - `createdAt` string, date-time
        - `createdBy` string, uuid
        - `lastUpdatedAt` string, date-time
        - `lastUpdatedBy` string, uuid
        - `lastUpdatedByAudience` string
        - `lastUpdatedByAudienceUuid` string, uuid
        - `lastUpdatedByImpersonatedBy` string, uuid
        - `lastUpdatedByCompanyUuid` string, uuid
        - `lastUpdatedByEnterpriseUuid` string, uuid
        - `name` string, required
        - `technicalName` string
        - `fileUrls` string[]
        - `mergeKeys` string[]
        - `templateId` string
        - `editEmbedUrl` string
        - `companyUuid` string, uuid
        - `technical` boolean
        - `counterSignEnabled` boolean
        - `coSignerRequired` boolean
        - `coSignerEmailCustomAttributeKey` string
        - `editUrl` string — Edit URL for embedded templates created via templateCreateEmbeddedDraft
        - `editUrlExpiresAt` number — Expiration timestamp (milliseconds) for the editUrl. Used to determine if editUrl is still valid.
      - `signDocUuid` string
      - `section2CompletionMethods` object[]
        - `methodName` 'authorizedRepresentative' | 'adminValidation' | 'onSiteVerification' | 'liveVideoVerification', required
        - `requiredDuration` number
        - `calendarGroupUuid` string
        - `eventDescription` string
        - `recommended` boolean
        - `reminder` number
        - `customConferencingEnabled` boolean
        - `customConferencing` object
          - `providerDescription` string
          - `joinUrl` string, url
      - `url` string
      - `bgcProvider` string
      - `bgcPackage` string
      - `tinProvider` string
      - `endEvent` string
      - `hideCompletedButton` boolean
      - `appendWxQueryParams` boolean
      - `sensitiveData` boolean
      - `useI9C2PayloadFormat` boolean
      - `triggerableType` 'flow' | 'task'
      - `triggerableTaskUuid` string
      - `companyAttributeSetUuid` string
      - `companyAttributeSet` object, nullable
        - `uuid` string, uuid
        - `createdAt` string, date-time
        - `createdBy` string, uuid
        - `lastUpdatedAt` string, date-time
        - `lastUpdatedBy` string, uuid
        - `lastUpdatedByAudience` string
        - `lastUpdatedByAudienceUuid` string, uuid
        - `lastUpdatedByImpersonatedBy` string, uuid
        - `lastUpdatedByCompanyUuid` string, uuid
        - `lastUpdatedByEnterpriseUuid` string, uuid
        - `companyUuid` string, required
        - `label` string, required
        - `description` string
        - `companyAttributes` object[]
          - `companyAttributeUuid` string
          - `value` union
            - string
            - string[]
            - number
            - boolean
            - object
              - …
          - `companyAttribute` object
            - `uuid` string, uuid
            - `createdAt` string, date-time
            - `createdBy` string, uuid
            - `lastUpdatedAt` string, date-time
            - `lastUpdatedBy` string, uuid
            - `lastUpdatedByAudience` string
            - `lastUpdatedByAudienceUuid` string, uuid
            - `lastUpdatedByImpersonatedBy` string, uuid
            - `lastUpdatedByCompanyUuid` string, uuid
            - `lastUpdatedByEnterpriseUuid` string, uuid
            - `label` string
            - `key` string
            - `dataType` 'string' | 'number' | 'date' | 'boolean' | 'select' | 'address' | 'media' | 'signature' | 'complianceDocument'
            - `description` string
            - `options` object[]
              - …
            - `hireUuid` string, uuid
            - `readOnly` boolean
            - `attachedToModel` 'location' | 'locationGroup' | 'job' | 'opening'
        - `attachedTo` object
          - `model` 'location' | 'locationGroup' | 'job' | 'opening'
          - `uuid` string
      - `customAttribute` object
        - `label` string
        - `uuid` string, required
        - `key` string
      - `instructionNotes` string
      - `attributesToReview` string[]
      - `requirementUuid` string, uuid — UUID of the compliance requirement from service-compliancev2
    - `requireReview` boolean
    - `reuseInRehire` boolean — When true (default), the task completion is carried over to the rehire profile. When false, the task starts incomplete in the rehire profile. Ignored for I-9, W-4, Background Check, and TIN Check tasks (always start incomplete).
    - `isInternal` boolean
    - `internalTaskData` object
      - `employerUuids` string[]
      - `trigger` object
        - `type` string
        - `taskUuid` string
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `500` — default error response

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)