Introduction
You can get some delegation data via REST.
/*<![CDATA[*/ div.rbtoc1769003354410 {padding: 0px;} div.rbtoc1769003354410 ul {list-style: disc;margin-left: 0px;} div.rbtoc1769003354410 li {margin-left: 0px;padding-left: 0px;} /*]]>*/ Introduction Authentication and Authorization Getting Delegation Data Get Delegates Get Delegators
Authentication and Authorization
All REST requests shown in this document require authentication.
Authentication is handled by the Jira instance that hosts the app. Basic Authentication and OAuth can be used.
In cases where the user cannot be authenticated or authorized, one of these error responses is returned:
Expand responses...
All endpoints will return the following responses on authentication and authorization-related errors.
Invalid Licence
HTTP 401
Invalid User
HTTP 401
When used user is not valid then JIRA serverreturns html page like that
Getting Delegation Data
Get Delegates
GET /rest/delegation/api/1.0/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.
<jira_url>/rest/delegation/api/1.0/delegation/getDelegates?delegator=<delegator>&category=<category>&datetime=<datetime>
Parameters
Examples
Responses
Expand responses...
Success
HTTP 200
Returns delegates of the delegator as JSON.
{ "delegator":"user1", "asOf":"2021-08-27 05:45:36 +0000", "category":"Expense", "delegates":[ "user2", "user3" ] }
Invalid Parameter
HTTP 400
When one of the required parameters is missing or one of the supplied parameter values is invalid.
{ "status":400, "message":"category is required.", "timestamp":1630043290559, "errors":{ "category":"category is required." } }
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 }
Not Found
HTTP 404
When one of the supplied parameter values is not found.
{ "status":404, "message":"Category with name \"test\" could not be found.", "timestamp":1630043572503 }
Get Delegators
GET /rest/delegation/api/1.0/delegation/getDelegators
Returns a JSON showing delegators of the given delegate in the given category.
Request
The request takes all parameters as query parameters.
<jira_url>/rest/delegation/api/1.0/delegation/getDelegators?delegate=<delegate>&category=<category>&datetime=<datetime>
Parameters
Examples
Responses
Expand responses...
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" ] }
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." } }
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 }
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 }