---
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` TaskResponseData — A discriminated union of task response data. Contains structured data collected when completing specific task types.
    - `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.
    - `responsibleParty` 'PROVIDER' | 'STEDI', required — The party responsible for completing a task.
    - `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
        - `provideInformation` ProvideInformationTask, required — Task for collecting specific information from the provider.
          - `instructions` string, required — Instructions explaining how to provide the necessary information.
    - `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`.
    - `completedAt` string, date-time — The timestamp when the task was completed.
    - `responseData` TaskResponseData — A discriminated union of task response data. Contains structured data collected when completing specific task types.
      - `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.
    - `isComplete` boolean, required — Whether the task has been marked as complete through either the API or the Stedi portal.
    - `id` string, required — The unique, Stedi-assigned identifier for the task.

## Other responses

- `400` — ValidationException 400 response
- `401` — UnauthorizedException 401 response
- `403` — AccessDeniedException 403 response
- `404` — ResourceNotFoundException 404 response
- `500` — InternalFailureException 500 response

## Changes

- **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/2c71286da5c8/schema)