Get All Delegators of Delegate | OBSS Apps Documentation

GET /rest/delegation/1.0/api/delegation/getDelegators

Returns a JSON showing delegators of the given delegate in the given category.

Request

The request takes all parameters as query parameters.

XML

<jira_url>/rest/delegation/1.0/api/delegation/getDelegators?delegate=<delegate>&category=<category>&datetime=<datetime>

Parameters

Expand parameters...

Parameter	Description	Location	Required	Value Samples
delegate	Username of the user whose delegators are to be queried. To query delegations of other users, the authenticated user must have View All permission. See Permissions	Query Parameter	Yes	user1
category	In which category the delegators will be searched. The value can be either general or the name of one of the categories created from the Delegation Categories page. See Delegation Categories	Query Parameter	Yes	general my category
datetime	The date for which delegators are queried. Valid format is yyyy-MM-dd HH:mm:ss. The given date will be evaluated according to the timezone of the Jira server. If no date is given, the current time of the Jira server will be used.	Query Parameter		2021-08-27 16:30:00

Parameter

Description

Location

Required

Value Samples

delegate

Username of the user whose delegators 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/getDelegators?delegate=user1&category=general&datetime=2021-05-10 12:45:00
https://192.168.0.1/rest/delegation/1.0/api/delegation/getDelegators?delegate=user2&category=expense

Responses

Expand responses...

200 - Success

Success

HTTP 200

Returns delegators of the delegate as JSON.

{ "delegate":"user1", "asOf":"2021-08-27 05:45:36 +0000", "category":"Expense", "delegators":[ "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.

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

403 - Missing Permission

Missing Permission

HTTP 403

When the querying user does not have the necessary permissions.

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

{ "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.

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