---
title: "POST /tasks/{taskId}"
method: POST
path: "/tasks/{taskId}"
---

# POST /tasks/{taskId}

`POST /tasks/{taskId}`

Updates a task associated with an enrollment.

## Path parameters

- `taskId` string, required — The Stedi-assigned identifier for the task to complete. You can get the task ID from either the [Retrieve Enrollment](/healthcare/api-reference/get-enrollment) or [List Enrollments](/healthcare/api-reference/get-enrollment-list-enrollments) endpoint.

## Request body

- UpdateTaskPostRequestContent — Input for UpdateTaskPost operation. Identical to UpdateTaskInput.
  - `completed` boolean — Indicates whether the task is completed. Set to `true` to mark the task as complete. If omitted, the default is `false`.
  - `responseData` union — A discriminated union of task response data. Contains structured data collected when completing specific task types.
    - object
      - `pdfUpload` PdfUploadResponse, required — Response data containing the uploaded PDF after completion.
        - `documentId` string, required — The document ID for the uploaded PDF, such as `019375d0-1234-7890-abcd-567890abcdef`. This ID is available in the response from the [Upload Enrollment Document](https://www.stedi.com/docs/healthcare/api-reference/post-enrollment-document-upload) endpoint. You can also retrieve it from the [Retrieve Enrollment](https://www.stedi.com/docs/healthcare/api-reference/get-enrollment) or [List Enrollments](https://www.stedi.com/docs/healthcare/api-reference/get-enrollment-list-enrollments) endpoints.
        - `fileName` string, required — The filename of the uploaded PDF, such as `completed-enrollment-form.pdf`. This should match the `name` you supplied when you called the [Upload Enrollment Document](https://www.stedi.com/docs/healthcare/api-reference/post-enrollment-document-upload) endpoint.
    - object
      - `provideInformation` ProvideInformationResponse, required — Response data for `ProvideInformation` task completion.
        - `response` string, required — Notes or confirmation text from the responsible party in response to completing a `ProvideInformation` task.

## Response `200`

UpdateTaskPost 200 response

- UpdateTaskPostResponseContent — Output for UpdateTaskPost operation. Identical to UpdateTaskOutput.
  - `task` Task, required — A task representing work that needs to be completed.
    - `completedAt` string, date-time — The timestamp when the task was completed.
    - `definition` union, required — A discriminated union of task definitions. Supports multiple task types with future extensibility.
      - object
        - `followInstructions` FollowInstructionsTask, required — Follow-instructions task data containing text instructions for a user to follow.
          - `instructions` string, required — Human-readable instructions for the responsible party to follow.
      - object
        - `provideFilledPdf` ProvideFilledPdfTask, required — Task for downloading, completing, and re-uploading a PDF document.
          - `documentDownloadUrl` string — The API URL for the [Download Enrollment Document](/healthcare/api-reference/get-enrollment-document-download) endpoint, with the document ID prepopulated. For example: `https://enrollments.us.stedi.com/2024-09-01/documents/019375d0-9876-7890-abcd-567890fedcba/download`. When you make an authenticated `GET` request to this URL, Stedi returns a pre-signed URL that you can use to download the PDF.
          - `instructions` string, required — Instructions explaining what needs to be completed within the PDF.
      - object
        - `provideInformation` ProvideInformationTask, required — Task for collecting specific information from the provider.
          - `instructions` string, required — Instructions explaining how to provide the necessary information.
    - `id` string, required — The unique, Stedi-assigned identifier for the task.
    - `isComplete` boolean, required — Whether the task has been marked as complete through either the API or the Stedi portal.
    - `rank` number, required — The rank order of this task. Tasks with lower numbers must be completed first. For example, a task with rank `1` must be completed before a task with rank `2`.
    - `responseData` union — A discriminated union of task response data. Contains structured data collected when completing specific task types.
      - object
        - `pdfUpload` PdfUploadResponse, required — Response data containing the uploaded PDF after completion.
          - `documentId` string, required — The document ID for the uploaded PDF, such as `019375d0-1234-7890-abcd-567890abcdef`. This ID is available in the response from the [Upload Enrollment Document](https://www.stedi.com/docs/healthcare/api-reference/post-enrollment-document-upload) endpoint. You can also retrieve it from the [Retrieve Enrollment](https://www.stedi.com/docs/healthcare/api-reference/get-enrollment) or [List Enrollments](https://www.stedi.com/docs/healthcare/api-reference/get-enrollment-list-enrollments) endpoints.
          - `fileName` string, required — The filename of the uploaded PDF, such as `completed-enrollment-form.pdf`. This should match the `name` you supplied when you called the [Upload Enrollment Document](https://www.stedi.com/docs/healthcare/api-reference/post-enrollment-document-upload) endpoint.
      - object
        - `provideInformation` ProvideInformationResponse, required — Response data for `ProvideInformation` task completion.
          - `response` string, required — Notes or confirmation text from the responsible party in response to completing a `ProvideInformation` task.
    - `responsibleParty` 'PROVIDER' | 'STEDI', required — The party responsible for completing a task.

## Other responses

- `400` — ValidationException 400 response
- `401` — UnauthorizedException 401 response
- `403` — AccessDeniedException 403 response
- `404` — ResourceNotFoundException 404 response
- `429` — QuotaExceededException 429 response
- `500` — InternalFailureException 500 response
- `503` — ServiceUnavailableException 503 response
- `504` — GatewayTimeoutException 504 response

## Changes

- **2026-03-20** `b2540c9ccf2d` — 1 breaking, 1 info
  - added `subschema #1: pdfUpload` to the `task/responseData` response property `oneOf` list for the response status `200`
  - added `subschema #1: pdfUpload` to the `responseData` request property `oneOf` list
- **2026-03-02** `2f49463384f4` — 1 breaking
  - added `subschema #2: provideFilledPdf` to the `task/definition` response property `oneOf` list for the response status `200`
- **2026-02-19** `9f17ab96c910` — 3 info
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the non-success response with the status `504`
- **2026-01-30** `dea4fec66c37` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stedi/apis/stedi-enrollment/changes/tasks/:taskId/post.md)

---

[API](https://skmtc.dev/stedi/apis/stedi-enrollment.md) · [All operations](https://skmtc.dev/stedi/apis/stedi-enrollment/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stedi/stedi-enrollment/revisions/e63a80da85e4/schema)