JIRA REST Scopes

For more information about the JIRA REST APIs, please consult the documentation on developer.atlassian.com and check out the Product API Browser

The required scope for your add-on depends on how you interact with the resources that are exposed by the REST API. The table below shows the required scope for GET, POST, PUT and DELETE operations on a resource path. REST resources are versioned by a path segment that varies with the version. The supported versions are listed below the path.

Example

Path	GET	POST	PUT	DELETE
`/rest/atlassian-connect/{version}/license` 1latest	READ	N/A	N/A	N/A

The example above means that a GET operation on

/rest/atlassian-connect/1/license
/rest/atlassian-connect/latest/license

will require your add-on to declare the READ scope. The example also shows that this specific resource only supports GET, but no other HTTP verbs.

Resources and their Associated Scopes

Path	GET	POST	PUT	DELETE
`/rest/api/{version}/attachment` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/comment` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/component` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/customFieldOption` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/field` 22.0.alpha1latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/api/{version}/filter` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/group` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/groups/picker` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/issue` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/issue/.+/worklog` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/issueLinkType` 22.0.alpha1latest	READ	ADMIN	ADMIN	ADMIN
`/rest/api/{version}/issuetype` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/mypermissions` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/myself` 2latest	READ	N/A	N/A	N/A
`/rest/api/{version}/priority` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/project` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/resolution` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/search` 22.0.alpha1latest	READ	WRITE	WRITE	N/A
`/rest/api/{version}/serverInfo` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/status` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/statuscategory` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/user` 22.0.alpha1latest	READ	N/A	N/A	N/A
`/rest/api/{version}/version` 22.0.alpha1latest	READ	WRITE	WRITE	DELETE
`/rest/api/{version}/workflow` 2latest	READ	N/A	N/A	N/A
`/rest/api/{version}/workflowscheme` 2latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/applinks/{version}/applicationlink` 1.02.0latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/applinks/{version}/applicationlinkInfo` 1.02.0latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/applinks/{version}/entities` 1.02.0latest	READ	N/A	N/A	N/A
`/rest/applinks/{version}/entitylink` 1.02.0latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/applinks/{version}/entitylink/primary` 1.02.0latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/applinks/{version}/listApplicationLinks` 1.02.0latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/applinks/{version}/manifest` 1.02.0latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/applinks/{version}/type/entity` 1.02.0latest	ADMIN	ADMIN	ADMIN	ADMIN
`/rest/atlassian-connect/{version}/license` 1latest	READ	N/A	N/A	N/A
`/rest/remoteplugintest/{version}/user` 1latest	READ	N/A	N/A	N/A
`/secure/attachment`	READ	N/A	N/A	N/A