Skip to main content
Version: Next

Get a task

GET 
/v1/tasks/:taskId

Get one task by id. Returns task or error when task does not exist.

Request​

Path Parameters

    taskId stringrequired

    The ID of the task.

Responses​

On success returned.

Schema
    id string

    The unique identifier of the task.

    name string

    The name of the task.

    taskDefinitionId string

    User task ID from the BPMN definition.

    processName string

    The name of the process.

    creationDate string

    When was the task created (renamed equivalent of Task.creationTime field).

    completionDate string

    When was the task completed (renamed equivalent of Task.completionTime field).

    assignee string

    The username/id of who is assigned to the task.

    taskState string

    Possible values: [CREATED, COMPLETED, CANCELED, FAILED]

    The state of the task.

    formKey string

    Reference to the task form.

    formId string

    Reference to the ID of a deployed form. If the form is not deployed, this property is null.

    formVersion int64

    Reference to the version of a deployed form. If the form is not deployed, this property is null.

    isFormEmbedded boolean

    Is the form embedded for this task? If there is no form, this property is null.

    processDefinitionKey string

    Reference to process definition (renamed equivalent of Task.processDefinitionId field).

    processInstanceKey string

    Reference to process instance id (renamed equivalent of Task.processInstanceId field).

    tenantId string

    The tenant ID associated with the task.

    dueDate date-time

    The due date for the task.

    followUpDate date-time

    The follow-up date for the task.

    candidateGroups string[]

    The candidate groups for the task.

    candidateUsers string[]

    The candidate users for the task.

    implementation string

    Possible values: [JOB_WORKER, ZEEBE_USER_TASK]

    priority integer

    Possible values: [0,100]

    Default value: 50

    The priority of a user task. The higher the value the higher the priority. Applicable only for Zeebe user tasks.

Loading...