--- 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. - object - `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 - … ## 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 — A task that requires uploading a PDF document. Stedi will either provide an enrollment template PDF to download and complete, or provide instructions for uploading supporting documentation, such as a W-9 form. - `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 template. This property is only present when Stedi provides a template to download. - `instructions` string, required — Instructions for the task. They describe what needs to be completed in a downloadable PDF template or what type of supporting documentation to upload. - object - `provideInformation` ProvideInformationTask, required — Task for collecting specific information from the provider. - `instructions` string, required — Instructions explaining how to provide the necessary information. - object - `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` 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. - object - `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. - … - `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/0a692cc4f303/schema)