Skip to main content
Version: Next

Update user task

PATCH 
/user-tasks/:userTaskKey

Update a user task with the given key.

Request​

Path Parameters

    userTaskKey int64required

    The key of the user task to update.

Body

    changeset objectnullable

    JSON object with changed task attribute values.

    The following attributes can be adjusted with this endpoint, additional attributes will be ignored:

    • candidateGroups - reset by providing an empty list
    • candidateUsers - reset by providing an empty list
    • dueDate - reset by providing an empty String
    • followUpDate - reset by providing an empty String
    • priority - minimum 0, maximum 100, default 50

    Providing any of those attributes with a null value or omitting it preserves the persisted attribute's value.

    The assignee cannot be adjusted with this endpoint, use the Assign task endpoint. This ensures correct event emission for assignee changes.

    dueDate date-timenullable

    The due date of the task. Reset by providing an empty String.

    followUpDate date-timenullable

    The follow-up date of the task. Reset by providing an empty String.

    candidateUsers string[]nullable

    The list of candidate users of the task. Reset by providing an empty list.

    candidateGroups string[]nullable

    The list of candidate groups of the task. Reset by providing an empty list.

    priority int32nullable

    Possible values: <= 100

    Default value: 50

    The priority of the task.

    property name* anynullable

    Additional properties allowed.

    action stringnullable

    A custom action value that will be accessible from user task events resulting from this endpoint invocation. If not provided, it will default to "update".

Responses​

The user task was updated successfully.

Loading...