Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
93 lines (65 sloc) 1.55 KB
title weight menu
Claim Task
60
main
name identifier parent pre
Claim
rest-api-task-post-claim
rest-api-task
POST `/task/{id}/claim`

Claims a task for a specific user.

Note: The difference with the [Set Assignee]({{< ref "/reference/rest/task/post-assignee.md" >}}) method is that here a check is performed to see if the task already has a user assigned to it.

Method

POST /task/{id}/claim

Parameters

Path Parameters

Name Description
id The id of the task to claim.

Request Body

A JSON object with the following properties:

Name Description
userId The id of the user that claims the task.

Result

This method returns no content.

Response Codes

Code Media type Description
204 Request successful.
500 application/json Task with given id does not exist or claiming was not successful. See the }}">Introduction for the error response format.

Example

Request

POST /task/anId/claim

Request Body:

{"userId": "aUserId"}

Response

Status 204. No content.

You can’t perform that action at this time.