Skip to content

Task Status Confirmation

Request
Description Allows a customer to confirm a scheduled task or a group of tasks with the same alternativeId. Only tasks scheduled from the same day on, having a possible status transition to the targeted status are confirmed.
URL /rs/v1/customer/task/confirm
Method POST
Content-Type application/x-www-form-urlencoded
Response Type No body — HTTP status code only
Form Parameter Datatype Required Description
configId Integer Yes The identifier of the configuration.
taskId String Yes The external identifier of the task.
status String Yes The target status code after confirmation.
authentication String Yes Authentication token UUID from the email link.
message String No Free-text message from the customer. Stored as a task note and triggers a notification email.

Response Codes

Code Meaning
200 Appointment confirmed successfully.
409 Appointment was already confirmed.
500 Server error.

The endpoint returns only an HTTP status code — no response body. The caller is responsible for mapping the status code to a user-facing message. This is typically handled by the respond form template.

This endpoint is normally called by the JavaScript in the appointmentRespondForm template, not directly from an email link. Direct email links open the /respond page first, which then POSTs to this endpoint.

Sample Call

POST /omdservices/rs/v1/customer/task/confirm
Content-Type: application/x-www-form-urlencoded

configId=16168276&taskId=AU-2022-46069_Weissach-282&status=IP-C&authentication=fe417f2e-be72-476d-955e-8db2c98f0463