--- 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. - `manualTask` ManualTaskResponse, required — Values provided when updating or completing a manual task. Visit [Manage enrollment tasks](https://www.stedi.com/docs/healthcare/transaction-enrollment-tasks-documents#api) for details. - `values` ManualTaskResponseKeyValue[], required — Values for fields in the task definition. Each value's `key` must have a corresponding field `key`. When updating a task without completing it, you can submit a subset of fields; the supplied values are merged into any previously saved values. Completing a task (`completed: true`) requires a value for every field. - `key` string, required — Identifier that matches a field `key` in the task definition. - `value` union, required — The value supplied for a `ManualTaskField`. The variant used must match the field's declared `FieldType`. Supply multiple entries with distinct keys to capture multiple documents or values. - object - `text` string, required — Free-form text when the `fieldType` is `TEXT`. - object - `document` ManualTaskDocumentResponseValue, required — A reference to a document uploaded to enrollment, supplied as the `document` variant of a `ManualTaskResponseValue`. - … ## 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` TaskDefinition, required — A discriminated union of task definitions. Supports multiple task types with future extensibility. - `manualTask` ManualTask, required — A task assigned to a responsible party that requires them to collect and submit a defined set of fields. The task is completed by supplying a `ManualTaskResponse` whose values satisfy the declared `fields`. - `fields` ManualTaskField[], required — Fields required to complete the task. Each entry defines the key, human-readable label, optional description, and type for values in the response. Can be empty for instruction-only tasks. - `description` string — Additional context explaining what to provide in the response. For example, details about what supporting documentation (such as the provider's W-9 form) is required. - `fieldType` 'TEXT' | 'DOCUMENT', required — The accepted field types for a manual task. - `key` string, required — A unique identifier for this field within the task, such as `ENROLLMENT_FORM`. - `label` string, required — Human-readable label for this field, such as `Provider NPI` or `Tax ID`. - `instructions` string, required — Instructions for completing the task. - `links` TaskLink[] — Links to help complete the task. This can include payer portals, reference documentation, or document download links for Stedi-provided template PDFs. - `label` string, required — Descriptive label for the URL, such as `Provider Portal` or `W-9 Template`. - `url` string, required — The URL for the resource. - `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` TaskResponseData — A discriminated union of task response data. Contains structured data collected when completing specific task types. - `manualTask` ManualTaskResponse, required — Values provided when updating or completing a manual task. Visit [Manage enrollment tasks](https://www.stedi.com/docs/healthcare/transaction-enrollment-tasks-documents#api) for details. - `values` ManualTaskResponseKeyValue[], required — Values for fields in the task definition. Each value's `key` must have a corresponding field `key`. When updating a task without completing it, you can submit a subset of fields; the supplied values are merged into any previously saved values. Completing a task (`completed: true`) requires a value for every field. - `key` string, required — Identifier that matches a field `key` in the task definition. - `value` union, required — The value supplied for a `ManualTaskField`. The variant used must match the field's declared `FieldType`. Supply multiple entries with distinct keys to capture multiple documents or values. - object - … - object - … - `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 --- [API](https://skmtc.net/stedi/apis/stedi-enrollment.md) · [All operations](https://skmtc.net/stedi/apis/stedi-enrollment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stedi/stedi-enrollment/revisions/f490f33d67ca/schema)