apidocs

UpdateTaskFinishDate API

Updates the finish date of a completed workflow task. Use this to retroactively correct a task’s recorded completion date when the original timestamp was inaccurate.

This operation only applies to already-completed tasks. To change the due date of an active task, use ChangeTaskDueDate.

Endpoint

/srv.asmx/UpdateTaskFinishDate

Methods

• GET /srv.asmx/UpdateTaskFinishDate?authenticationTicket=...&taskId=...&finishDate=...
• POST /srv.asmx/UpdateTaskFinishDate (form data)
• SOAP Action: http://tempuri.org/UpdateTaskFinishDate

Parameters

Parameter	Type	Required	Description
authenticationTicket	string	Yes	Authentication ticket obtained from AuthenticateUser.
taskId	integer	Yes	Unique numeric ID of the completed task to update.
finishDate	DateTime	Yes	New finish date to record for the task. Recommended format: yyyy-MM-ddTHH:mm:ss.

Response

Success Response

<root success="true" />

Error Response

<root success="false" error="Access Denied" />

Required Permissions

The calling user must be either:

• The original task assignee who also has the Change Finish Date permission on the task, or
• A workflow supervisor for the task.

Anonymous access is not permitted.

Eligible Task States

Only completed tasks can have their finish date updated:

Status	Allowed
Completed	Yes
InProgress	No
DueDateChanged	No
NotStarted	No
Dropped	No
Reassigned	No

Example

GET Request

GET /srv.asmx/UpdateTaskFinishDate
    ?authenticationTicket=3f7a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c
    &taskId=4812
    &finishDate=2024-04-10T14:30:00
HTTP/1.1
Host: yourserver

POST Request

POST /srv.asmx/UpdateTaskFinishDate HTTP/1.1
Host: yourserver
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f7a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c&taskId=4812&finishDate=2024-04-10T14%3A30%3A00

Notes

• The Change Finish Date permission is configured on the workflow task definition. If the assignee does not have this permission, only the supervisor can update the finish date.
• This API does not validate whether finishDate is in the past or future.
• To retrieve a task’s current finish date, use GetTask.

Related APIs

• GetTask -“ Get full details of a task including its current finish date.
• ChangeTaskDueDate -“ Change the due date of an active (not yet completed) task.
• CompleteTask -“ Complete a task (sets the finish date automatically).

Error Codes

Error	Description
[900]	Authentication failed -“ invalid credentials.
[901]	Session expired or invalid authentication ticket.
Task not found	No task with the specified taskId exists.
Access Denied	Calling user is not the task assignee with Change Finish Date permission, or a supervisor.
Task not completed	The task is not in Completed state.