Get All Delegates of Delegator

GET /rest/delegation/1.0/api/delegation/getDelegates

Returns a JSON that shows the delegates of the given delegator in the given category.

Request

The request takes all parameters as query parameters.

XML

<jira_url>/rest/delegation/1.0/api/delegation/getDelegates?delegator=<delegator>&category=<category>&datetime=<datetime>

Parameters

Expand parameters...

Parameter

Description

Location

Required

Value Samples

delegator

Jira username of the user whose delegates are to be queried.

To query delegations of other users, the authenticated user must have View All permission.

See Permissions

Query Parameter

Yes

user1

Examples

Expand examples...

XML

https://192.168.0.1/rest/delegation/1.0/api/delegation/getDelegates?delegator=user1&category=general&datetime=2021-05-10 12:45:00
https://192.168.0.1/rest/delegation/1.0/api/delegation/getDelegates?delegator=user2&category=expense

Responses

Expand responses...

200 - Success

Success

HTTP 200

Returns delegates of the delegator as JSON.

JS

{
   "delegator":"user1",
   "asOf":"2021-08-27 05:45:36 +0000",
   "category":"Expense",
   "delegates":[
      "user2",
      "user3"
   ]
}

400 - Invalid parameter

Invalid Parameter

HTTP 400

When one of the required parameters is missing or one of the supplied parameter values is invalid.

JS

{
   "status":400,
   "message":"category is required.",
   "timestamp":1630043290559,
   "errors":{
      "category":"category is required."
   }
}

403 - Missing Permission

Missing Permission

HTTP 403

When the querying user does not have the necessary permissions.

JS

{
   "status":403,
   "message":"You do not have permission to view delegations.",
   "timestamp":1630044510592
}

JS

{
   "status":403,
   "message":"You do not have permission to query delegations of other users.",
   "timestamp":1630044510592
}

404 - Not found

Not Found

HTTP 404

When one of the supplied parameter values is not found.

JS

{
   "status":404,
   "message":"Category with name \"test\" could not be found.",
   "timestamp":1630043572503
}