Switches the API client to the app context.
Switches the API client to the user context.
This resource represents an announcement banner. Use it to retrieve and update banner configuration.
This resource represents app access rule data policies.
This resource represents application roles. Use it to get details of an application role or all application roles.
This resource supports app migrations. Use it to:
This resource represents app properties. Use it to store arbitrary data for your Connect app.
This resource represents audits that record activities undertaken in Jira. Use it to get a list of audit records.
This resource represents system and custom avatars. Use it to obtain the details of system or custom avatars, add and remove avatars from a project, issue type or priority and obtain avatar images.
This resource represents classification levels.
This resource represents dashboards. Use it to obtain the details of dashboards as well as get, create, update, or remove item properties and gadgets from dashboards.
This resource represents modules registered dynamically by Connect apps.
This resource represents filters. Use it to get, create, update, or delete filters. Also use it to configure the columns for a filter and set favorite filters.
This resource represents options for sharing filters. Use it to get share scopes as well as add and remove share scopes from filters.
This resource represents a list of users and a list of groups. Use it to obtain the details to populate user and group picker suggestions list.
This resource represents groups of users. Use it to get, create, find, and delete groups as well as add and remove users from groups. ([WARNING] The standard Atlassian group names are default names only and can be edited or deleted. For example, an admin or Atlassian support could delete the default group jira-software-users or rename it to jsw-users at any point. See https://support.atlassian.com/user-management/docs/create-and-update-groups/ for details.)
This resource represents issue attachments and the attachment settings for Jira. Use it to get the metadata for an attachment, delete an attachment, and view the metadata for the contents of an attachment. Also, use it to get the attachment settings for Jira.
This resource represents the issue bulk operations. Use it to move multiple issues from one project to another project or edit fields of multiple issues in one go.
For additional clarity, we have created a page with further examples and answers to frequently asked questions related to these APIs. You can access it here: Bulk operation APIs: additional examples and FAQ.
Access to the issue bulk operations requires authentication. For information on how to authenticate API requests, refer to the Basic auth for REST APIs documentation.
The bulk edit and move APIs are subject to the usual rate limiting infrastructure in Jira. For more information, refer to Rate limiting. Additionally, at any given time, only 5 concurrent requests can be sent across all users.
This resource represents issue comment properties, which provides for storing custom data against an issue comment. Use is to get, set, and delete issue comment properties as well as obtain the keys of all properties on a comment. Comment properties are a type of entity property.
This resource represents issue comments. Use it to:
This resource represents configurations stored against a custom field context by a Forge app. Configurations are information used by the Forge app at runtime to determine how to handle or process the data in a custom field in a given context. Use this resource to set and read configurations.
This resource represents issue custom field contexts. Use it to:
This resource represents custom issue field select list options created in Jira or using the REST API. This resource supports the following field types:
See Issue custom field options (apps) to manipulate custom issue field select list options created by a Connect app.
Use it to retrieve, create, update, order, and delete custom field options.
This resource represents custom issue field select list options created by a Connect app. See Issue custom field options to manipulate options created in Jira or using the REST API.
A select list issue field is a type of issue field that enables a user to select an option from a list. Use it to add, remove, and update the options of a select list issue field.
This resource represents the values of custom fields added by Forge apps. Use it to update the value of a custom field on issues.
This resource represents issue field configurations. Use it to get, set, and delete field configurations and field configuration schemes.
This resource represents issue fields, both system and custom fields. Use it to get fields, field configurations, and create custom fields.
This resource represents links between issues. Use it to get, create, and delete links between issues.
To use it, the site must have issue linking enabled.
This resource represents issue link types. Use it to get, create, update, and delete link issue types as well as get lists of all link issue types.
To use it, the site must have issue linking enabled.
This resource represents issue navigator settings. Use it to get and set issue navigator default columns.
This resource represents notification schemes, lists of events and the recipients who will receive notifications for those events. Use it to get details of a notification scheme and a list of notification schemes.
A notification scheme is a list of events and recipients who will receive
notifications for those events. The list is contained within the
notificationSchemeEvents object and contains pairs of events and
notifications:
event Identifies the type of event. The events can be Jira system
events
(see the Events section) or custom
events.
notifications Identifies the
recipients
of notifications for each event. Recipients can be any of the following types:
CurrentAssigneeReporterCurrentUserProjectLeadComponentLeadUser (the parameter is the user key)Group (the parameter is the group name)ProjectRole (the parameter is the project role ID)EmailAddress (deprecated)AllWatchersUserCustomField (the parameter is the ID of the custom field)GroupCustomField(the parameter is the ID of the custom field)This resource represents issue priorities. Use it to get, create and update issue priorities and details for individual issue priorities.
This resource represents issue properties, which provides for storing custom data against an issue. Use it to get, set, and delete issue properties as well as obtain details of all properties on an issue. Operations to bulk update and delete issue properties are also provided. Issue properties are a type of entity property.
This resource represents remote issue links, a way of linking Jira to information in other systems. Use it to get, create, update, and delete remote issue links either by ID or global ID. The global ID provides a way of accessing remote issue links using information about the item's remote system host and remote system identifier.
This resource represents issue resolution values. Use it to obtain a list of all issue resolution values and the details of individual resolution values.
This resource represents Jira issues. Use it to:
This resource represents various ways to search for issues. Use it to search for issues with a JQL query and find issues to populate an issue picker.
This resource represents issue security levels. Use it to obtain the details of any issue security level. For more information about issue security levels, see Configuring issue-level security.
This resource represents issue security schemes. Use it to get an issue security scheme or a list of issue security schemes.
Issue security schemes control which users or groups of users can view an issue. When an issue security scheme is associated with a project, its security levels can be applied to issues in that project. Sub-tasks also inherit the security level of their parent issue.
This resource represents issue type properties, which provides for storing custom data against an issue type. Use it to get, create, and delete issue type properties as well as obtain the keys of all properties on a issues type. Issue type properties are a type of entity property.
This resource represents issues types. Use it to:
This resource represents issue type schemes in classic projects. Use it to:
This resource represents issue type screen schemes. Use it to:
This resource represents votes cast by users on an issue. Use it to get details of votes on an issue as well as cast and withdrawal votes.
This resource represents users watching an issue. Use it to get details of users watching an issue as well as start and stop a user watching an issue.
This resource represents issue worklog properties, which provides for storing custom data against an issue worklog. Use it to get, create, and delete issue worklog properties as well as obtain the keys of all properties on a issue worklog. Issue worklog properties are a type of entity property.
This resource represents issue worklogs. Use it to:
This resource is a collection of operations for Jira expressions.
This resource represents various settings in Jira. Use it to get and update Jira settings and properties.
This resource represents JQL search auto-complete details. Use it to obtain JQL search auto-complete data and suggestions for use in programmatic construction of queries or custom query builders. It also provides operations to:
This resource represents JQL function's precomputations. Precomputation is a mapping between custom function call and JQL fragment returned by this function. Use it to get and update precomputations.
This resource represents available labels. Use it to get available labels for the global label field.
This resource represents license metrics. Use it to get available metrics for Jira licences.
This resource represents information about the current user, such as basic details, group membership, application roles, preferences, and locale. Use it to get, create, update, and delete (restore default) values of the user's preferences and locale.
This resource represents permissions. Use it to obtain details of all permissions and determine whether the user has certain permissions.
This resource represents permission schemes. Use it to get, create, update, and delete permission schemes as well as get, create, update, and delete details of the permissions granted in those schemes.
This resource represents plans. Use it to get, create, duplicate, update, trash and archive plans.
This resource represents issue priority schemes. Use it to get priority schemes and related information, and to create, update and delete priority schemes.
This resource represents avatars associated with a project. Use it to get, load, set, and remove project avatars.
This resource represents project categories. Use it to create, update, and delete project categories as well as obtain a list of all project categories and details of individual categories. For more information on managing project categories, see Adding, assigning, and deleting project categories.
This resource represents classification levels used in a project. Use it to view and manage classification levels in your projects.
This resource represents project components. Use it to get, create, update, and delete project components. Also get components for project and get a count of issues by component.
This resource represents the email address used to send a project's notifications. Use it to get and set the project's sender email address.
This resource represents project features. Use it to get the list of features for a project and modify the state of a feature. The project feature endpoint is available only for Jira Software, both for team- and company-managed projects.
This resource provides validation for project keys and names.
This resource represents permission schemes for a project. Use this resource to:
See Managing project permissions for more information about permission schemes.
This resource represents project properties, which provides for storing custom data against a project. Use it to get, create, and delete project properties as well as get a list of property keys for a project. Project properties are a type of entity property.
This resource represents the users assigned to project roles. Use it to get, add, and remove default users from project roles. Also use it to add and remove users from a project role associated with a project.
This resource represents the roles that users can play in projects. Use this resource to get, create, update, and delete project roles.
This resource represents projects. Use it to get, create, update, and delete projects. Also get statuses available to a project, a project's notification schemes, and update a project's type.
This resource represents project types. Use it to obtain a list of all project types, a list of project types accessible to the calling user, and details of a project type.
This resource represents project versions. Use it to get, get lists of, create, update, move, merge, and delete project versions. This resource also provides counts of issues by version.
This resource represents the screens used to record issue details. Use it to:
This resource represents screen schemes in classic projects. Use it to get, create, update, and delete screen schemes.
This resource represents the screen tab fields used to record issue details. Use it to get, add, move, and remove fields from screen tabs.
This resource represents the screen tabs used to record issue details. Use it to get, create, update, move, and delete screen tabs.
This resource provides information about the Jira instance.
This resource represents a service registry. Use it to retrieve attributes related to a service registry in JSM.
This resource represents statuses. Use it to search, get, create, delete, and change statuses.
This resource represents a long-running asynchronous tasks. Use it to obtain details about the progress of a long-running task or cancel a long-running task.
This resource represents planning settings for plan-only and Atlassian teams in a plan. Use it to get, create, update and delete planning settings.
This resource represents time tracking and time tracking providers. Use it to get and set the time tracking provider, get and set the time tracking options, and disable time tracking.
UI modifications is a feature available for Forge apps only. It enables Forge apps to control how selected Jira fields behave on the following views: global issue create, issue view, issue transition. For example: hide specific fields, set them as required, etc.
This resource represents user properties and provides for storing custom data against a user. Use it to get, create, and delete user properties as well as get a list of property keys for a user. This resourse is designed for integrations and apps to store per-user data and settings. This enables data used to customized the user experience to be kept in the Jira Cloud instance's database. User properties are a type of entity property.
This resource does not access the user properties created and maintained in Jira.
This resource represent users. Use it to:
This resource represents various ways to search for and find users. Use it to obtain list of users including users assignable to projects and issues, users with permissions, user lists for pickup fields, and user lists generated using structured queries. Note that the operations in this resource only return users found within the first 1000 users.
This resource represents webhooks. Webhooks are calls sent to a URL when an event occurs in Jira for issues specified by a JQL query. Only Connect and OAuth 2.0 apps can register and manage webhooks. For more information, see Webhooks.
This resource represents workflows. Use it to:
This resource represents draft workflow schemes. Use it to manage drafts of workflow schemes.
A workflow scheme maps issue types to workflows. A workflow scheme can be associated with one or more projects, which enables the projects to use the workflow-issue type mappings.
Active workflow schemes (workflow schemes that are used by projects) cannot be edited. Editing an active workflow scheme creates a draft copy of the scheme. The draft workflow scheme can then be edited and published (replacing the active scheme).
See Configuring workflow schemes for more information.
This resource represents the associations between workflow schemes and projects.
For more information, see Managing your workflows.
This resource represents workflow schemes. Use it to manage workflow schemes and the workflow scheme's workflows and issue types.
A workflow scheme maps issue types to workflows. A workflow scheme can be associated with one or more projects, which enables the projects to use the workflow-issue type mappings.
Active workflow schemes (workflow schemes that are used by projects) cannot be edited. When an active workflow scheme is edited, a draft copy of the scheme is created. The draft workflow scheme is then be edited and published (replacing the active scheme).
See Configuring workflow schemes for more information.
This resource represents status categories. Use it to obtain a list of all status categories and the details of a category. Status categories provided a mechanism for categorizing statuses.
This resource represents issue workflow statuses. Use it to obtain a list of all statuses associated with workflows and the details of a status.
This resource represents workflow transition properties, which provides for storing custom data against a workflow transition. Use it to get, create, and delete workflow transition properties as well as get a list of property keys for a workflow transition. Workflow transition properties are a type of entity property.
This resource represents workflow transition rules. Workflow transition rules define a Connect or a Forge app routine, such as a workflow post functions that is executed in association with the workflow. Use it to read and modify configuration of workflow transition rules.
The Jira Cloud Platform REST API Client.