Get user task (alpha)
GET/user-tasks/:userTaskKey
Get the user task by the user task key.
Note that this endpoint is an alpha feature and not enabled on Camunda clusters out of the box. The Camunda 8 API (REST) Overview page provides further details.
This endpoint is an alpha feature and may be subject to change in future releases.
Request
Path Parameters
The user task key.
Responses
- 200
- 400
- 404
- 500
The user task is successfully returned.
- application/json
- Schema
- Example (from schema)
Schema
The key for this user task.
Possible values: [CREATED
, COMPLETED
, CANCELED
, FAILED
]
The state of the user task.
The assignee of the user task.
The element ID of the user task.
The key of the element instance.
The candidate groups for this user task.
The candidate users for this user task.
The ID of the process definition.
The key of the process definition.
The key of the process instance.
The key of the form.
The creation date of a user task.
The completion date of a user task.
The follow date of a user task.
The due date of a user task.
Tenant ID of this user task.
The external form reference.
The version of the process definition.
customHeaders object
Custom headers for the user task.
Possible values: <= 100
Default value: 50
The priority of a user task. The higher the value the higher the priority.
{
"userTaskKey": 0,
"state": "CREATED",
"assignee": "string",
"elementId": "string",
"elementInstanceKey": 0,
"candidateGroups": [
"string"
],
"candidateUsers": [
"string"
],
"processDefinitionId": "string",
"processDefinitionKey": 0,
"processInstanceKey": 0,
"formKey": 0,
"creationDate": "2024-11-07T21:11:50.802Z",
"completionDate": "2024-11-07T21:11:50.802Z",
"followUpDate": "2024-11-07T21:11:50.802Z",
"dueDate": "2024-11-07T21:11:50.802Z",
"tenantId": "string",
"externalFormReference": "string",
"processDefinitionVersion": 0,
"customHeaders": {},
"priority": 50
}
The provided data is not valid. More details are provided in the response body.
- application/problem+json
- Schema
- Example (from schema)
Schema
Default value: about:blank
A URI identifying the problem type.
A summary of the problem type.
Possible values: >= 400
and <= 600
The HTTP status code for this problem.
An explanation of the problem in more detail.
A URI identifying the origin of the problem.
{
"type": "about:blank",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
The user task with the given key was not found.
- application/problem+json
- Schema
- Example (from schema)
Schema
Default value: about:blank
A URI identifying the problem type.
A summary of the problem type.
Possible values: >= 400
and <= 600
The HTTP status code for this problem.
An explanation of the problem in more detail.
A URI identifying the origin of the problem.
{
"type": "about:blank",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
An internal error occurred while processing the request.
- application/problem+json
- Schema
- Example (from schema)
Schema
Default value: about:blank
A URI identifying the problem type.
A summary of the problem type.
Possible values: >= 400
and <= 600
The HTTP status code for this problem.
An explanation of the problem in more detail.
A URI identifying the origin of the problem.
{
"type": "about:blank",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}