Jira
Learn how to use Jira with Composio
Overview
Enum
JIRA
Description
Jira API tool
Authentication Details
OAUTH2
API_KEY
Actions
JIRA_ADD_ACTORS_TO_PROJECT_ROLE
Add actors to a project role; replace using the provided link. anonymous access allowed. requires ‘administer projects’ or ‘administer jira’ permissions.
Action Parameters
Action Response
JIRA_ADD_ATTACHMENT
Attach files to a jira issue using multipart/form-data and ‘x-atlassian-token: no-check’ header. include ‘file’ parameter; examples in various languages. requires ‘browse projects’ and ‘create attachments’ permissions, anonymous allowed. (DEPRECATED use JIRA_ADD_ATTACHMENT_TO_ISSUE)
Action Parameters
Action Response
JIRA_ADD_ATTACHMENT_TO_ISSUE
This tool allows users to add attachments to a jira issue. it enables users to attach files such as screenshots, documents, or other files to a specific issue.
Action Parameters
Action Response
JIRA_ADD_COMMENT
This tool adds a new comment to a specified jira issue. the comment can include formatted text using the atlassian document format (adf). it uses the api endpoint post /rest/api/3/issue/{issueidorkey}/comment to create a comment.
Action Parameters
Action Response
JIRA_ADD_DEFAULT_ACTORS_TO_PROJECT_ROLE
Add either groups or users, not both, as default actors to a jira role. existing projects’ roles remain unchanged. admin rights required.
Action Parameters
Action Response
JIRA_ADD_FIELD_TO_DEFAULT_SCREEN
Adds a field to the default tab of the default screen. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_ADD_FILTER_AS_FAVORITE
Users can mark filters as favorites in jira if they own it, are in a group it’s shared with, or if it’s shared with a project or the public they have access to. permissions needed.
Action Parameters
Action Response
JIRA_ADD_GADGET_TO_DASHBOARD
Adds a gadget to a dashboard. permissions required: none.
Action Parameters
Action Response
JIRA_ADD_ISSUE_SECURITY_LEVELS
Adds levels and levels’ members to the issue security scheme. you can add up to 100 levels per request. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_ADD_ISSUE_SECURITY_LEVEL_MEMBERS
Adds members to the issue security level. you can add up to 100 members per request. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_ADD_ISSUE_TYPES_TO_CONTEXT
Issue types can be added to a jira custom field context, limiting its application to those types only. if types are already present, the add fails. admin permissions needed.
Action Parameters
Action Response
JIRA_ADD_ISSUE_TYPES_TO_ISSUE_TYPE_SCHEME
This operation appends new issue types to a scheme in jira. if any issue types already exist within the scheme, the process fails. administer jira global permission is required.
Action Parameters
Action Response
JIRA_ADD_NOTIFICATIONS_TO_NOTIFICATION_SCHEME
Add up to 1000 notifications to a scheme, note that emailaddress type is deprecated in cloud. administer jira global permission is required. see changelog and permissions docs for details.
Action Parameters
Action Response
JIRA_ADD_SCREEN_TAB_FIELD
Adds a field to a screen tab. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_ADD_USER_TO_GROUP
Adds a user to a group. permissions required: site administration (that is, member of the site-admin group).
Action Parameters
Action Response
JIRA_ADD_VOTE
User can vote on an issue in jira if the voting option is enabled in general configuration. necessary permissions include browsing projects and viewing the issue if issue-level security is set. see provided links for details.
Action Parameters
Action Response
JIRA_ADD_WATCHER
To add a user to an issue’s watcher list, use the account id or default to the caller. ensure “allow users to watch issues” is on, and appropriate permissions, including “manage watcher list” for adding others, are granted.
Action Parameters
Action Response
JIRA_ADD_WATCHER_TO_ISSUE
This tool adds a user as a watcher to a specified jira issue. watchers will receive notifications about updates to the issue. this operation requires the “allow users to watch issues” option to be on. this option is set in general configuration for jira. permissions required: - browse projects permission for the project containing the issue - if issue-level security is configured, issue-level security permission to view the issue - to add users other than themselves to the watchlist, manage watcher list project permission
Action Parameters
Action Response
JIRA_ADD_WORKLOG
Adds a worklog to a jira issue. requires time tracking enabled and “browse projects” & “work on issues” permissions. allows anonymous access but may need issue-level security permission.
Action Parameters
Action Response
JIRA_ANALYSE_JIRA_EXPRESSION
This operation analyzes and confirms the validity of jira expressions and can optionally type-check them. it’s experimental, with no permissions needed. learn more in the documentation.
Action Parameters
Action Response
JIRA_APPEND_MAPPINGS_TO_ISSUE_TYPE_SCREEN_SCHEME
Appends issue type to screen scheme mappings to an issue type screen scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_ARCHIVE_ISSUE_S_BY_ISSUE_ID_KEY
Admins can archive 1000 issues per request, with archive status and errors reported. subtasks archived via parents. limited to certain project types. jira or site admin rights, premium or enterprise license, and signed-in users required.
Action Parameters
Action Response
JIRA_ARCHIVE_ISSUE_S_BY_JQL
Admins can archive 100k jira issues per request with jql; includes status url, task management apis, and project type limits. requires jira admin rights, premium/enterprise license, and non-anonymous access; only one active request allowed per instance.
Action Parameters
Action Response
JIRA_ARCHIVE_PROJECT
Archive a project to prevent deletion. restore it via the jira ui to delete it afterward. administer jira global permission is necessary.
Action Parameters
Action Response
JIRA_ASSIGN_CUSTOM_FIELD_CONTEXT_TO_PROJECTS
The text describes an operation that assigns custom field contexts to projects, which fails if a project is already assigned a context. administer jira global permission is needed.
Action Parameters
Action Response
JIRA_ASSIGN_FIELD_CONFIGURATION_SCHEME_TO_PROJECT
Assigns a field config scheme to a project or defaults if null. only for classic projects. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_ASSIGN_ISSUE
Assigns an issue to a user. use this operation when the calling user does not have the edit issues permission but has the assign issue permission for the project that the issue is in. if account id is set to: - “-1”, the issue is assigned to the default assignee for the project. - null, the issue is set to unassigned. permissions required: - browse projects and assign issues project permission for the project that the issue is in. - if issue-level security is configured, issue-level security permission to view the issue.
Action Parameters
Action Response
JIRA_ASSIGN_ISSUE_TYPES_TO_FIELD_CONFIGURATIONS
This operation assigns issue types to field configs in a scheme, limited to company-managed projects, and requires administer jira global permission.
Action Parameters
Action Response
JIRA_ASSIGN_ISSUE_TYPE_SCHEME_TO_PROJECT
The text outlines the process to assign an issue type scheme to a classic jira project, noting that it fails if there are issues with types not in the new scheme. admin rights are required.
Action Parameters
Action Response
JIRA_ASSIGN_ISSUE_TYPE_SCREEN_SCHEME_TO_PROJECT
The text explains that only users with “administer jira” permissions can assign issue type screen schemes to classic projects.
Action Parameters
Action Response
JIRA_ASSIGN_PERMISSION_SCHEME
Assigned a permission scheme to a project. for details, visit the provided links. requires “administer jira” global permission.
Action Parameters
Action Response
JIRA_ASSIGN_WORKFLOW_SCHEME_TO_PROJECT
Workflow schemes are designated to classic projects without issues by users with the ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_ASSOCIATE_SECURITY_SCHEME_TO_PROJECT
Assigns an issue security scheme to a project, optionally remapping issue security levels. the task is asynchronous; track status via the ‘location’ link. admin rights required.
Action Parameters
Action Response
JIRA_BULK_CREATE_ISSUE
Creates multiple issues or sub-tasks in bulk. this action allows for the creation of up to 50 issues in a single request. each issue can be a standard issue or a subtask, depending on the issue type specified.
Action Parameters
Action Response
JIRA_BULK_CREATE_STATUSES
Summary: the text outlines that to create statuses applicable across global or project levels, one must have “administer projects” and “administer jira” permissions.
Action Parameters
Action Response
JIRA_BULK_CREATE_WORKFLOWS
To create workflows and their statuses in jira, users need ‘administer jira’ permission for global workflows and ‘administer projects’ for project-specific ones.
Action Parameters
Action Response
JIRA_BULK_DELETE_ISSUE_PROPERTY
The tool asynchronously removes a property from filtered issues transactionally. results are clickable links. without filters, all issues are affected. edit and browse permissions, plus issue security compliance, are needed.
Action Parameters
Action Response
JIRA_BULK_DELETE_STATUSES
Deletes statuses by id; requires ‘administer projects’ and ‘administer jira’ project permissions.
Action Parameters
Action Response
JIRA_BULK_EDIT_DASHBOARDS
Bulk edit dashboards. maximum number of dashboards to be edited at the same time is 100. permissions required: none the dashboards to be updated must be owned by the user, or the user must be an administrator.
Action Parameters
Action Response
JIRA_BULK_GET_GROUPS
Returns a paginated list of groups. permissions required: browse users and groups global permission.
Action Parameters
Action Response
JIRA_BULK_GET_STATUSES
Fetches a list of statuses for given status ids. requires ‘administer projects’ and ‘administer jira’ permissions.
Action Parameters
Action Response
JIRA_BULK_GET_USERS
Returns a paginated list of the users specified by one or more account ids. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_BULK_GET_WORKFLOWS
Get a list of workflows and statuses using names, ids, or by project/issue type. requires ‘administer jira’ for all or ‘administer projects’/‘view workflow’ for project-level access.
Action Parameters
Action Response
JIRA_BULK_GET_WORKFLOW_SCHEMES
Get a list of workflow schemes with scheme/project ids. requires ‘administer jira’ for all schemes, ‘administer projects’ for project-specific ones.
Action Parameters
Action Response
JIRA_BULK_SET_ISSUES_PROPERTIES_BY_LIST
Updates up to 10k issues with ≤10 properties per issue in json format. single property capped at 32,768 chars. allows anonymous use, transactional and async. needs ‘browse projects,’ ‘edit issues,’ and issue security view permissions.
Action Parameters
Action Response
JIRA_BULK_SET_ISSUE_PROPERTIES_BY_ISSUE
Updates issue entity properties for up to 100 issues asynchronously; limited to 10 properties per issue with valid json in the request body. the operation is non-transactional, and permissions like ‘browse projects’ and ‘edit issues’ are required.
Action Parameters
Action Response
JIRA_BULK_SET_ISSUE_PROPERTY
Jira allows setting property values on multiple issues with constants or expressions, filtering by various criteria. updates to properties are transactional, asynchronous, and require proper permissions.
Action Parameters
Action Response
JIRA_BULK_UPDATE_CUSTOM_FIELD_VALUE
Updates the value of a custom field added by connect apps on one or more issues. the values of up to 200 custom fields can be updated. permissions required: only connect apps can make this request
Action Parameters
Action Response
JIRA_BULK_UPDATE_STATUSES
Updates statuses by id, requiring “administer projects” and “administer jira” permissions. more info at provided atlassian links.
Action Parameters
Action Response
JIRA_BULK_UPDATE_WORKFLOWS
Permissions needed to update workflows: “administer jira” for all/global workflows, and “administer projects” for project-specific workflows.
Action Parameters
Action Response
JIRA_CANCEL_TASK
Cancels a task. permissions required: either of: * administer jira global permission. * creator of the task.
Action Parameters
Action Response
JIRA_CHANGE_FILTER_OWNER
Changes the owner of the filter. permissions required: permission to access jira. however, the user must own the filter or have the administer jira global permission.
Action Parameters
Action Response
JIRA_CHANGE_ORDER_OF_ISSUE_TYPES
Reorders issue types in a scheme; requires all types in scheme & either ‘after’ or ‘position’ specified—excluding ‘after’ type from the list. admin jira rights needed.
Action Parameters
Action Response
JIRA_CHECK_ISSUES_AGAINST_JQL
The text describes a process to check if jql queries will return any issues. no specific permissions are needed, but the user must have ‘browse projects’ permission and, if applicable, issue-level security permission to view the issues.
Action Parameters
Action Response
JIRA_CLASSIC_UPDATE_WORKFLOW_SCHEME
Updates a company-managed project workflow scheme and its components. if active, updates/creates a draft scheme if updatedraftifneeded is true. admin jira permissions needed.
Action Parameters
Action Response
JIRA_CONVERT_USER_IDENTIFIERS_TO_ACCOUNT_IDS_IN_JQL_QUERIES
This tool transforms jql queries with usernames or user keys to ones using account ids for gdpr compliance. important for systems storing jqls. access to jira is necessary. see the migration guide for gdpr changes.
Action Parameters
Action Response
JIRA_COPY_DASHBOARD
Copies a dashboard. any values provided in the dashboard parameter replace those in the copied dashboard. permissions required: none the dashboard to be copied must be owned by or shared with the user.
Action Parameters
Action Response
JIRA_CREATE_COMPONENT
Create a component to organize issues in a project. anonymous access allowed, but requires project admin or global jira admin permissions.
Action Parameters
Action Response
JIRA_CREATE_CUSTOM_FIELD
Creates a custom field. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_CUSTOM_FIELD_CONTEXT
A custom field context is created; if no projectids, it’s global (for all projects); if no issuetypeids, it affects all issue types. admin jira rights required.
Action Parameters
Action Response
JIRA_CREATE_CUSTOM_FIELD_OPTIONS_CONTEXT
Allows creation of up to 1000 select and cascading field options per request for a jira custom field (max 10,000 options). use the issue custom field options for connect apps. admin rights needed.
Action Parameters
Action Response
JIRA_CREATE_DASHBOARD
Creates a dashboard. permissions required: none.
Action Parameters
Action Response
JIRA_CREATE_DRAFT_WORKFLOW_SCHEME
Draft a workflow scheme by cloning an active one; an active scheme allows only one draft. admin rights in jira are needed.
Action Parameters
Action Response
JIRA_CREATE_FIELD_CONFIGURATION
New field configuration with optional fields is created, mirroring default settings, for company-managed projects. administer jira global permission is needed.
Action Parameters
Action Response
JIRA_CREATE_FIELD_CONFIGURATION_SCHEME
Creates field configuration schemes for company-managed projects. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_CREATE_FILTER
Creates a filter. the filter is shared according to the default share scope. the filter is not selected as a favorite. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_CREATE_GROUP
Creates a group. permissions required: site administration (that is, member of the site-admin group).
Action Parameters
Action Response
JIRA_CREATE_ISSUE
Creates a new issue in jira with specified fields, updates, and properties. this endpoint allows for comprehensive issue creation, supporting standard jira fields as well as custom fields and issue properties. it can be used to initiate new tasks, bugs, stories, or any other issue type defined in your jira project. the endpoint is particularly useful for automating issue creation from external systems or for bulk issue creation. it provides flexibility in setting initial issue state, including the ability to specify transitions, add history metadata, and set custom properties. however, it’s important to note that the fields available and required may vary depending on the specific jira configuration and issue type being created. proper permissions are necessary to create issues in the specified project. (DEPRECATED use JIRA_CREATE_ISSUE_TICKET)
Action Parameters
Action Response
JIRA_CREATE_ISSUE_FIELD_OPTION
This operation adds options to select list issue fields specifically for connect apps, not for native jira fields or other methods. each field and option can have up to 10,000 options or scopes. administer jira global permission is required.
Action Parameters
Action Response
JIRA_CREATE_ISSUE_LINK
Creates a link between two jira issues with an optional comment. the link type must be a valid link type name in your jira instance. requires appropriate permissions to view and link the specified issues.
Action Parameters
Action Response
JIRA_CREATE_ISSUE_LINK_TYPE
Create an issue link type in jira to define why issues are linked, including names/descriptions for relationship directions. requires issue linking enabled and ‘administer jira’ permissions.
Action Parameters
Action Response
JIRA_CREATE_ISSUE_SECURITY_SCHEME
The text describes a system that allows creation of a security scheme with up to 100 levels and members per level, requiring “administer jira” global permissions.
Action Parameters
Action Response
JIRA_CREATE_ISSUE_TICKET
Creates a new issue in jira. this action allows users to create various types of issues (bugs, tasks, stories, etc.) in a specified jira project. it requires parameters such as project key, summary, and issue type, and supports optional parameters like description, assignee, priority, labels, components, and custom fields.
Action Parameters
Action Response
JIRA_CREATE_ISSUE_TYPE
Creates an issue type and adds it to the default issue type scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_ISSUE_TYPE_SCHEME
Creates an issue type scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_ISSUE_TYPE_SCREEN_SCHEME
Creates an issue type screen scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_NOTIFICATION_SCHEME
Creates a notification scheme with notifications. you can create up to 1000 notifications per request. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_OR_UPDATE_REMOTE_ISSUE_LINK
This operation creates/updates a remote issue link for an issue, using a globalid. it requires “browse projects” & “link issues” permissions and, if applicable, issue-level security permission. accessible anonymously if issue linking is enabled.
Action Parameters
Action Response
JIRA_CREATE_PERMISSION_GRANT
Creates a permission grant in a permission scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_PERMISSION_SCHEME
New permission scheme creation is available, with or without specifying permissions. requires “administer jira” global permission.
Action Parameters
Action Response
JIRA_CREATE_PRIORITY
Creates an issue priority. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_PROJECT
Creates a new project in jira. this action allows you to create a project with specified configurations including project type, template, permissions, and other settings. the project type and template must be compatible - see the project template key field description for valid combinations. requires jira admin permissions.
Action Parameters
Action Response
JIRA_CREATE_PROJECT_CATEGORY
Creates a project category. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_PROJECT_ROLE
A new project role without default actors can be created and later assigned actors. note: existing projects won’t get new actors automatically. admin rights required.
Action Parameters
Action Response
JIRA_CREATE_RESOLUTION
Creates an issue resolution. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_SCREEN
Creates a screen with a default field tab. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_SCREEN_SCHEME
Creates a screen scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_SCREEN_TAB
Creates a tab for a screen. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_SPRINT
This tool creates a future sprint in jira. the sprint name and origin board id are required parameters. the tool allows for creating a new sprint with optional parameters like start date, end date, and goal.
Action Parameters
Action Response
JIRA_CREATE_UI_MODIFICATION
Forge apps can make ui changes with or without explicit permissions, supporting 3000 modifications, each with 1000 contexts. however, there’s a cap of 100 modifications for each context.
Action Parameters
Action Response
JIRA_CREATE_USER
This legacy api creates a jira user; if the user exists with jira access, it returns a 201 status; without access, a 400 status. admin jira permissions are required. it will be deprecated for a better option.
Action Parameters
Action Response
JIRA_CREATE_VERSION
This tool creates a new version in a jira project. it uses the post /rest/api/3/version endpoint and accepts parameters like name, description, projectid, released, archived, releasedate, and startdate to track project releases and milestones.
Action Parameters
Action Response
JIRA_CREATE_WORKFLOW
The text explains how to create jira workflow rules, covering conditions, validators, and post functions for transitions, with a bulk create option and a guide [linked]. admin rights are needed.
Action Parameters
Action Response
JIRA_CREATE_WORKFLOW_SCHEME
Creates a workflow scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_CREATE_WORKFLOW_TRANSITION_PROPERTY
Property added to workflow transition alters behavior. details at atlassian docs. requires ‘administer jira’ global permission. more info: transition & workflow properties links.
Action Parameters
Action Response
JIRA_DELETE_ACTORS_FROM_PROJECT_ROLE
This procedure removes actors from a project role and can be done without logging in. requires either “administer projects” project or “administer jira” global permissions. use the provided link for default actor removal.
Action Parameters
Action Response
JIRA_DELETE_AND_REPLACE_VERSION
Deletes a project version and allows substitution with another from the same project. access requires ‘administer jira’ or ‘administer projects’ permissions and can be done anonymously.
Action Parameters
Action Response
JIRA_DELETE_APP_PROPERTY
An authorized connect app with a matching addonkey can delete its property. also, forge apps can delete properties if they share the app.connect.key.
Action Parameters
Action Response
JIRA_DELETE_APP_PROPERTY_FORGE
Deletes a forge app’s property. permissions required: only forge apps can make this request.
Action Parameters
Action Response
JIRA_DELETE_ATTACHMENT
Removes an issue attachment. anonymous access allowed. requires project permissions: “delete own attachments” for user-created attachments or “delete all attachments” for any attachment.
Action Parameters
Action Response
JIRA_DELETE_AVATAR
Deletes an avatar from a project or issue type. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_COMMENT
This tool will delete a comment from a jira issue using the delete /rest/api/3/issue/{issueidorkey}/comment/{id} endpoint. it requires the following parameters: issueidorkey (string) for the id or key of the issue, and id (string) for the id of the comment. the operation requires specific permissions including: browse projects, issue-level security permissions if applicable, and delete permissions (either delete all comments or delete own comments).
Action Parameters
Action Response
JIRA_DELETE_COMMENT_PROPERTY
To delete a comment property, users need “edit all comments” to delete any property or “edit own comments” to delete their own. additionally, if a comment is restricted, the user must belong to that specific role or group.
Action Parameters
Action Response
JIRA_DELETE_COMPONENT
Anonymous users can delete a component if they have either “administer projects” permission for the related project or “administer jira” global permission. see provided links for details.
Action Parameters
Action Response
JIRA_DELETE_CUSTOM_FIELD
Deletes a custom field permanently, asynchronous operation, track status via ‘location’ link. requires ‘administer jira’ global permission. more info on deletion at atlassian documentation.
Action Parameters
Action Response
JIRA_DELETE_CUSTOM_FIELD_CONTEXT
The provided text indicates that to delete a custom field context in jira, one needs to have the ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_DELETE_CUSTOM_FIELD_OPTIONS_CONTEXT
This operation allows deletion of a custom field option in jira, but cascading options must be removed first. it applies to jira-created fields, not connect app fields. requires jira admin permissions.
Action Parameters
Action Response
JIRA_DELETE_DASHBOARD
Deletes a dashboard. permissions required: none the dashboard to be deleted must be owned by the user.
Action Parameters
Action Response
JIRA_DELETE_DASHBOARD_ITEM_PROPERTY
Removes a dashboard property and doesn’t require login. user must own the dashboard or have administer jira global permission to qualify.
Action Parameters
Action Response
JIRA_DELETE_DEFAULT_ACTORS_FROM_PROJECT_ROLE
Removes default actors from a project role in jira, with the restriction of deleting either a group or user per request, not both. pre-existing project roles remain unaffected. admin jira rights are required.
Action Parameters
Action Response
JIRA_DELETE_DEFAULT_WORKFLOW
Resets default workflow to jira’s system workflow; active schemes need updatedraftifneeded=true for edits, creating/updating a draft that can be published. requires administer jira permission.
Action Parameters
Action Response
JIRA_DELETE_DRAFT_DEFAULT_WORKFLOW
Resets a draft workflow scheme’s default to jira’s system workflow; requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_DELETE_DRAFT_WORKFLOW_SCHEME
Deletes a draft workflow scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_FIELD_CONFIGURATION
Delete field configurations only from company-managed projects. requires ‘administer jira’ global permission. see provided links for details.
Action Parameters
Action Response
JIRA_DELETE_FIELD_CONFIGURATION_SCHEME
Deletes a field configuration scheme, applicable only in company-managed projects. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_DELETE_FILTER
To delete a filter in jira, you need access permission. only the filter creator or a user with ‘administer jira’ global permission can perform the deletion.
Action Parameters
Action Response
JIRA_DELETE_INACTIVE_WORKFLOW
A workflow can only be deleted if it’s not active, a system workflow, or linked to any (draft) workflow scheme. administer jira global permissions required.
Action Parameters
Action Response
JIRA_DELETE_ISSUE
Deletes a jira issue. an issue cannot be deleted if it has subtasks unless deletesubtasks is true. permissions required: - browse projects and delete issues project permission for the project containing the issue - if issue-level security is configured, issue-level security permission to view the issue
Action Parameters
Action Response
JIRA_DELETE_ISSUE_FIELD_OPTION
This operation removes options only from select lists added by connect apps in jira fields, not options created in jira or with issue custom field options. admin jira global permission is required, but no jira permissions for the app’s field.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_LINK
This operation allows anonymous users to delete an issue link provided they have the ‘browse project’ permission for all linked projects, ‘link issues’ permission for at least one project, and view access if issue-level security is set.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_LINK_TYPE
This operation removes an issue link type in jira, but it requires the site to have issue linking enabled and the user to have ‘administer jira’ global permissions.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_PROPERTY
This operation allows anonymous users to delete an issue’s property, provided they have ‘browse projects’ and ‘edit issues’ permissions for the project, and issue-level security permissions if applicable.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_SECURITY_SCHEME
Deletes an issue security scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_TYPE
Deletes an issue type, substituting all instances with an alternative issue type. requires ‘administer jira’ permission. alternative types can be found at the provided resources.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_TYPES_FOR_WORKFLOW_IN_DRAFT_WORKFLOW_SCHEME
Deletes the workflow-issue type mapping for a workflow in a workflow scheme’s draft. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_TYPES_FOR_WORKFLOW_IN_WORKFLOW_SCHEME
Removes a workflow-issue type mapping from a workflow scheme in jira. active schemes must use updatedraftifneeded for edits, creating or updating a draft that can be published. admin rights required.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_TYPE_PROPERTY
The text provides instructions to remove the “issue type property” in jira, noting that “administer jira” global permission is necessary for this operation.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_TYPE_SCHEME
Issue type schemes from classic projects can be deleted. projects using the scheme switch to the default. admin rights in jira are needed.
Action Parameters
Action Response
JIRA_DELETE_ISSUE_TYPE_SCREEN_SCHEME
Deletes an issue type screen scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_LOCALE
Use the user management rest api’s update a user profile instead of deprecated method to revert user’s locale to default. requires jira access permission.
Action Parameters
Action Response
JIRA_DELETE_NOTIFICATION_SCHEME
Deletes a notification scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_PERMISSION_SCHEME
Deletes a permission scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_PERMISSION_SCHEME_GRANT
Removes a permission grant from a scheme; requires administer jira global permission. details: about permission schemes and grants.
Action Parameters
Action Response
JIRA_DELETE_PREFERENCE
The text describes how to reset a user preference to default settings in jira, noting that ‘jira.user.locale’ and ‘jira.user.timezone’ are deprecated, and recommending the user management rest api with proper permissions.
Action Parameters
Action Response
JIRA_DELETE_PRIORITY
The text announces the deprecation of an issue priority deletion api, referring to the changelog for details. the deletion process is asynchronous, requiring admin permissions for jira, with status updates accessible via provided links.
Action Parameters
Action Response
JIRA_DELETE_PROJECT
To delete a project in jira, it must not be archived. first, restore it using the jira ui, if necessary. administer jira global permission is required.
Action Parameters
Action Response
JIRA_DELETE_PROJECT_ASYNCHRONOUSLY
Project deletion is asynchronous and transactional; if it fails, the project remains. track progress via ‘location’ link and ‘get task’. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_DELETE_PROJECT_AVATAR
Deletes a custom avatar from a project. note that system avatars cannot be deleted. permissions required: administer projects project permission.
Action Parameters
Action Response
JIRA_DELETE_PROJECT_CATEGORY
Deletes a project category. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_PROJECT_PROPERTY
This operation removes a property from a project in jira and can be done anonymously, but requires either ‘administer jira’ global or ‘administer projects’ project permissions.
Action Parameters
Action Response
JIRA_DELETE_PROJECT_ROLE
Deletes an in-use project role if a replacement is provided. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_DELETE_REMOTE_ISSUE_LINK_BY_GLOBAL_ID
Remove a remote issue link using its global id with escaped url characters. issue linking must be active. anonymous access allowed. requires ‘browse projects’ and ‘link issues’ permissions, plus issue-level security if applicable.
Action Parameters
Action Response
JIRA_DELETE_REMOTE_ISSUE_LINK_BY_ID
This operation deletes a remote issue link and requires active issue linking. anonymous access is allowed. permissions needed: browse, edit, and link issues within the project, and issue-level security if set.
Action Parameters
Action Response
JIRA_DELETE_RESOLUTION
Asynchronously deletes an issue resolution. track the task status through the ‘location’ link response and use ‘get task’ for updates. administer jira global permission is required.
Action Parameters
Action Response
JIRA_DELETE_SCREEN
Deletes a screen. a screen cannot be deleted if it is used in a screen scheme, workflow, or workflow draft. only screens used in classic projects can be deleted.
Action Parameters
Action Response
JIRA_DELETE_SCREEN_SCHEME
Screen schemes in classic projects can be deleted unless linked to an issue type screen scheme. admin jira global permission is needed.
Action Parameters
Action Response
JIRA_DELETE_SCREEN_TAB
Deletes a screen tab. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_UI_MODIFICATION
Deletes a ui modification. all the contexts that belong to the ui modification are deleted too. ui modification can only be deleted by forge apps. permissions required: none.
Action Parameters
Action Response
JIRA_DELETE_USER
Removes a user from jira’s user base if successful. does not affect their atlassian account. site admin permissions required.
Action Parameters
Action Response
JIRA_DELETE_USER_PROPERTY
This operation removes a property from a user in jira. to delete any user’s property, the ‘administer jira’ permission is needed; to delete from one’s own record, jira access suffices. it does not affect jira’s user properties.
Action Parameters
Action Response
JIRA_DELETE_VERSION
This tool allows you to delete a version in jira. a version is a milestone or release point in a project that can be used to track progress and organize issues. the delete operation can be customized to handle associated issues and fix versions. permissions required: - administer jira global permission or - administer projects project permission for the project that contains the version
Action Parameters
Action Response
JIRA_DELETE_VOTE
The process removes a user’s vote from an issue in jira, which needs ‘allow users to vote on issues’ enabled in general config. permissions needed: ‘browse projects’ for the project and issue-level security if applicable. see jira docs for details.
Action Parameters
Action Response
JIRA_DELETE_WATCHER
To delete an issue watcher in jira, “allow users to watch issues” must be enabled. requires “browse projects” permission, issue-level security view access, and “manage watcher list” to remove others. see links for configuration and permissions.
Action Parameters
Action Response
JIRA_DELETE_WEBHOOKS_BY_ID
Deletes only the calling app’s webhooks by id, ignoring others. requires connect and oauth 2.0 app permissions.
Action Parameters
Action Response
JIRA_DELETE_WORKFLOW_FOR_ISSUE_TYPE_IN_DRAFT_WORKFLOW_SCHEME
Deletes the issue type-workflow mapping for an issue type in a workflow scheme’s draft. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_DELETE_WORKFLOW_FOR_ISSUE_TYPE_IN_WORKFLOW_SCHEME
Removes issue type-workflow mapping from a jira workflow scheme. for active schemes, set updatedraftifneeded to true to create/update a draft. admin jira permissions required.
Action Parameters
Action Response
JIRA_DELETE_WORKFLOW_SCHEME
You can delete a workflow scheme in jira only if it’s not currently active. admin rights are required for this action.
Action Parameters
Action Response
JIRA_DELETE_WORKFLOW_TRANSITION_PROPERTY
The text provides instructions for removing a property from a workflow transition, which affects its behavior. references include detailed documentation on transition and workflow properties. admin rights in jira are required.
Action Parameters
Action Response
JIRA_DELETE_WORKFLOW_TRANSITION_RULE_CONFIGURATIONS
This operation allows connect apps to delete their own post functions, conditions, and validators from workflows. permissions are exclusive to connect apps.
Action Parameters
Action Response
JIRA_DELETE_WORKLOG
Deletes a worklog from an issue. the user must have permission to delete the worklog by being the worklog author, having the delete all worklogs permission, or the administer project permission.
Action Parameters
Action Response
JIRA_DELETE_WORKLOG_PROPERTY
Removes a worklog property, available without login. requires ‘browse projects’ permission, issue-level security permission if set, and appropriate group or role if worklog visibility is restricted.
Action Parameters
Action Response
JIRA_EDIT_ISSUE
Issue edits update properties but not transitions via update and fields, accessible by key/id. to remove parent, use update.parent.set.none. admins may override screen security; anonymous edits allowed with correct permissions.
Action Parameters
Action Response
JIRA_EVALUATE_JIRA_EXPRESSION
Test jira expressions to fetch data or plan usage with the jira expressions documentation. context variables such as user, issue, and project can be used. anonymous access is allowed; permissions influence outcomes.
Action Parameters
Action Response
JIRA_EXPORT_ARCHIVED_ISSUE_S
Admins can use an api to receive an email with a csv link for archived issues; it includes system fields but not custom ones. jira/site admin rights, a premium/enterprise plan, and sign-in are needed. only one active request is allowed.
Action Parameters
Action Response
JIRA_EXTEND_WEBHOOK_LIFE
Use this operation to extend the life of rest api webhooks beyond 30 days; it ignores webhooks with unrecognized ids. only connect and oauth 2.0 apps are permitted to use this.
Action Parameters
Action Response
JIRA_FETCH_MIGRATED_WORKFLOW_RULE_DETAILS
Returns configurations for workflow transition rules migrated from server to cloud and owned by the calling connect app.
Action Parameters
Action Response
JIRA_FIND_COMPONENTS_FOR_PROJECTS
Get a paginated list of all project components, including global ones, anonymously. requires “browse projects” permission for the project.
Action Parameters
Action Response
JIRA_FIND_GROUPS
This service retrieves and highlights groups based on a search, suggesting matches while filtering unwanted ones. it sorts the results, shows totals, and allows anonymous queries with limited features.
Action Parameters
Action Response
JIRA_FIND_USERS
The operation searches for and filters active users based on a string and property, displays them within a range, allows anonymous access, respects privacy, and needs ‘browse users and groups’ permission for results.
Action Parameters
Action Response
JIRA_FIND_USERS_AND_GROUPS
Search tool matches users/groups with query, insensitive for users but sensitive for groups. supports detailed searches with result highlighting. anonymous use allowed, but specific permission required.
Action Parameters
Action Response
JIRA_FIND_USERS_ASSIGNABLE_TO_ISSUES
List users eligible for jira issue assignment using projectkeyorid for new issues or issuekey for updates. during transitions, add actiondescriptorid. user privacy and selection range may limit results. access requires specific permissions.
Action Parameters
Action Response
JIRA_FIND_USERS_ASSIGNABLE_TO_PROJECTS
Returns a list of assignable users in projects, filtering by attributes. it picks from a start point and up to a max, often returning fewer users. privacy settings may hide some info. can be accessed anonymously; no permissions required.
Action Parameters
Action Response
JIRA_FIND_USERS_BY_QUERY
The operation retrieves users matching a query, often less than maxresults, using and/or for roles/properties. ‘browse users and groups’ permission required.
Action Parameters
Action Response
JIRA_FIND_USERS_FOR_PICKER
The tool matches and highlights user queries, supports exclusions, and might return fewer results than the maximum due to privacy. use “get all users” for full results. anonymous searches yield exact names with restrictions.
Action Parameters
Action Response
JIRA_FIND_USERS_WITH_BROWSE_PERMISSION
Summarize user search for those with issue browsing ability by issuekey or projectkey. limited results due to permissions; privacy settings apply. anonymous access if permitted. see docs for details.
Action Parameters
Action Response
JIRA_FIND_USERS_WITH_PERMISSIONS
Generates a user list based on criteria, access levels, and scope while respecting privacy. fully inclusive without searches. accessible without login but needs jira or admin rights.
Action Parameters
Action Response
JIRA_FIND_USER_KEYS_BY_QUERY
The operation searches and returns a paginated list of users based on a query, with filters and limits defined by startat and maxresults. it requires appropriate permissions and can handle complex queries with logical operators.
Action Parameters
Action Response
JIRA_FULLY_UPDATE_PROJECT_ROLE
Update a project role’s name and description in jira; both fields are required. admin privileges needed. links provided for permissions details.
Action Parameters
Action Response
JIRA_GET_ACCESSIBLE_PROJECT_TYPE_BY_KEY
Returns a project type if it is accessible to the user. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_ACCOUNT_IDS_FOR_USERS
Returns the account ids for the users specified in the key or username parameters. note that multiple key or username parameters can be specified. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_ADVANCED_SETTINGS
Access jira’s advanced settings via: jira icon > jira settings > system > general configuration, click advanced settings. requires administer jira permission.
Action Parameters
Action Response
JIRA_GET_ALL_APPLICATION_ROLES
The text provides instructions for jira administrators to manage application roles via a specific configuration page, noting that the “administer jira” global permission is required.
Action Parameters
Action Response
JIRA_GET_ALL_CLASSIFICATION_LEVELS
Returns all classification levels. permissions required: none.
Action Parameters
Action Response
JIRA_GET_ALL_DASHBOARDS
Returns a list of dashboards owned by or shared with the user. the list may be filtered to include only favorite or owned dashboards. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_ALL_FIELD_CONFIGURATIONS
Retrieve a paginated list of field configurations for company-managed projects, filterable by item ids, defaults, or search terms. requires ‘administer jira’ permission.
Action Parameters
Action Response
JIRA_GET_ALL_FIELD_CONFIGURATION_SCHEMES
The text provides a link for obtaining a paginated list of field configuration schemes specific to classic projects, with a requirement of the ‘administer jira’ global permission for access.
Action Parameters
Action Response
JIRA_GET_ALL_ISSUE_FIELD_OPTIONS
Fetches a paginated list of select list issue field options added by connect apps. not for jira-created options. requires administer jira permission; no jira permissions needed for the app’s field.
Action Parameters
Action Response
JIRA_GET_ALL_ISSUE_TYPES_FOR_USER
The operation allows anonymous access to issue types. users with administer jira permission can see all types; those with browse projects see types linked to accessible projects.
Action Parameters
Action Response
JIRA_GET_ALL_ISSUE_TYPE_SCHEMES
Retrieves a paginated list of issue type schemes for classic projects. requires “administer jira” global permission.
Action Parameters
Action Response
JIRA_GET_ALL_LABELS
Returns a paginated list of labels.
Action Parameters
Action Response
JIRA_GET_ALL_METADATA_FOR_AN_EXPANDED_ATTACHMENT
Summarizes metadata retrieval for attachments, specifically zip files. includes id and name access, with project browsing rights and issue security permissions if needed. anonymous access allowed.
Action Parameters
Action Response
JIRA_GET_ALL_PERMISSIONS
Returns all permissions, including: * global permissions. * project permissions. * global permissions added by plugins. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_ALL_PERMISSION_SCHEMES
Jira’s permission schemes pair holders with specific permissions based on holder type and id, covering project and issue management, with the option for custom permissions.
Action Parameters
Action Response
JIRA_GET_ALL_PROJECTS
Deprecated method returns all projects a user can see. use the paginated “get projects” with search support instead. anonymous access available. requires ‘browse’ or ‘administer’ project permissions.
Action Parameters
Action Response
JIRA_GET_ALL_PROJECT_AVATARS
This api returns both system and custom project avatars without login. users need ‘browse projects’ permission for access.
Action Parameters
Action Response
JIRA_GET_ALL_PROJECT_CATEGORIES
Returns all project categories. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_ALL_PROJECT_ROLES
Jira cloud project roles let users customize member associations per project, affecting permissions and workflows. “actors” are users/groups in roles, adjustable by admins either as defaults or per project.
Action Parameters
Action Response
JIRA_GET_ALL_PROJECT_TYPES
Returns all project types, whether or not the instance has a valid license for each type. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_ALL_SCREEN_TABS
Lists tabs on a screen, requiring “administer jira” global permission or “administer projects” within a project, linked via screen and issue type screen schemes.
Action Parameters
Action Response
JIRA_GET_ALL_SCREEN_TAB_FIELDS
Summary: this function retrieves all fields for a jira screen tab, requiring “administer jira” global permission or “administer projects” permission if a project key is provided and the screen is linked via screen and issue type screen schemes.
Action Parameters
Action Response
JIRA_GET_ALL_STATUSES
Returns a list of all statuses available in jira. this action retrieves information about all issue statuses, including their ids, names, descriptions, and categories. this is particularly useful for workflow management and understanding the possible states an issue can be in.
Action Parameters
Action Response
JIRA_GET_ALL_STATUSES_FOR_PROJECT
This api returns valid statuses for project issues, based on issue type. accessible anonymously but requires “browse projects” permission for the relevant project.
Action Parameters
Action Response
JIRA_GET_ALL_STATUS_CATEGORIES
Returns a list of all status categories. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_ALL_TIME_TRACKING_PROVIDERS
Jira has a default time tracking provider, with more available via atlassian marketplace apps. admin rights are needed for access and configuration. for details, visit the time tracking provider module.
Action Parameters
Action Response
JIRA_GET_ALL_USERS
Get all users in jira action class. this action retrieves a list of all jira users including active, inactive, and deleted users that have not been removed from the database. it supports pagination parameters such as startat and maxresults, and requires ‘browse users and groups’ permission. returns: a list of user objects containing user details like account id, display name, email, etc.
Action Parameters
Action Response
JIRA_GET_ALL_USERS_DEFAULT
Provides a list of all atlassian account users with privacy filters applied based on preferences, which might hide emails. requires “browse users and groups” permission. more info on profile visibility is available.
Action Parameters
Action Response
JIRA_GET_ALL_WORKFLOWS
Deprecated method returns either a single workflow or all jira workflows; use “get workflows paginated” instead. requires “administer jira” global permission. if workflowname is given, a single object is returned, otherwise an array.
Action Parameters
Action Response
JIRA_GET_ALL_WORKFLOW_SCHEMES
The service provides a paged list of all jira workflow schemes, excluding drafts. it requires the ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_ALTERNATIVE_ISSUE_TYPES
Provides a list of alternative issue types sharing the same workflow, field configuration, and screen schemes. accessible without login. no permissions required.
Action Parameters
Action Response
JIRA_GET_ANNOUNCEMENT_BANNER_CONFIGURATION
Returns the current announcement banner configuration. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_APPLICATION_PROPERTY
Get a single application property by specifying a key or an array of all editable properties. administer jira rights required. see links for property descriptions and permissions.
Action Parameters
Action Response
JIRA_GET_APPLICATION_ROLE
Returns an application role. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_APPROXIMATE_APPLICATION_LICENSE_COUNT
Retrieves an estimated count of user accounts for a jira license, data cached for 7 days. administer jira global permission required.
Action Parameters
Action Response
JIRA_GET_APPROXIMATE_LICENSE_COUNT
This api returns an estimate of jira user accounts, caching data for 7 days. admin rights are required for access.
Action Parameters
Action Response
JIRA_GET_APP_PROPERTIES
Summary: connect app with matching addonkey can retrieve all its properties. forge apps also have access to these properties if linked to the same app.connect.key. permissions required.
Action Parameters
Action Response
JIRA_GET_APP_PROPERTY
Returns an app’s property key and value. access is limited to the connect app with a matching addonkey and forge apps with the same app.connect.key. permissions are required.
Action Parameters
Action Response
JIRA_GET_ASSIGNED_PERMISSION_SCHEME
Retrieves the project’s permission scheme. requires ‘administer jira’ global permission or ‘administer projects’ project permission.
Action Parameters
Action Response
JIRA_GET_ATTACHMENT_CONTENT
Retrieves attachment contents with optional byte range. use ‘get attachment thumbnail’ for images. accessible anonymously, but requires ‘browse projects’ permission and issue-level security access if set. see http range header for byte ranges.
Action Parameters
Action Response
JIRA_GET_ATTACHMENT_METADATA
Retrieves an attachment’s metadata without returning the file. accessible anonymously; requires ‘browse projects’ permission and, if applicable, issue-level security permission.
Action Parameters
Action Response
JIRA_GET_ATTACHMENT_THUMBNAIL
Generates a thumbnail for an attachment, accessible without login. requires ‘browse projects’ permission and, if applicable, issue-level security permission. details: get attachment content.
Action Parameters
Action Response
JIRA_GET_AUDIT_RECORDS
Returns filtered audit records based on matches in specified fields, date range, and requires ‘administer jira’ global permission. filters include summary, category, event source, and various objectitem attributes.
Action Parameters
Action Response
JIRA_GET_AVAILABLE_GADGETS
Gets a list of all available gadgets that can be added to all dashboards. permissions required: none.
Action Parameters
Action Response
JIRA_GET_AVAILABLE_SCREEN_FIELDS
Returns the fields that can be added to a tab on a screen. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_AVAILABLE_WORKFLOW_CAPABILITIES
Access workflow features with workflow/project id, including scope, types, rules, and sources. admin rights required. api gives details for validators/conditions and post functions.
Action Parameters
Action Response
JIRA_GET_AVATARS
This operation retrieves both system and custom avatars for projects or issue types, accessible even anonymously. custom avatars require the “browse projects” permission for the relevant project or issue type. system avatars require no permissions.
Action Parameters
Action Response
JIRA_GET_AVATAR_IMAGE_BY_ID
Get a project or issue type avatar image by id. accessible without login for system avatars; requires “browse projects” permission for custom avatars related to specific projects or issue types.
Action Parameters
Action Response
JIRA_GET_AVATAR_IMAGE_BY_OWNER
This operation retrieves avatar images for projects or issue types, available anonymously. no permissions needed for system avatars. custom avatars require ‘browse projects’ permission for the related project or issue type.
Action Parameters
Action Response
JIRA_GET_AVATAR_IMAGE_BY_TYPE
Returns the default project or issue type avatar image. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_BULK_PERMISSIONS
The operation displays user access to projects/issues, defaults to the user, ignores invalid input, and caps at 1000. post-06/15/2024, anonymous users allowed, others require admin, and connected apps gain more rights.
Action Parameters
Action Response
JIRA_GET_BULK_SCREEN_TABS
Returns the list of tabs for a bulk of screens. permissions required: * administer jira global permission.
Action Parameters
Action Response
JIRA_GET_CHANGELOGS
Access a paginated, date-ordered list of issue changelogs anonymously. requires ‘browse projects’ permission and, if set, issue-level security clearance.
Action Parameters
Action Response
JIRA_GET_CHANGELOGS_BY_IDS
Retrieve issue changelogs by their ids; accessible without login. requires ‘browse projects’ permission and, if applicable, issue-level security clearance.
Action Parameters
Action Response
JIRA_GET_COLUMNS
Retrieves filter’s column configuration used in list view when columns set to filter, available anonymously. only returns details for filters owned, shared with user’s group, or projects where user has permissions.
Action Parameters
Action Response
JIRA_GET_COMMENT
This tool retrieves a specific comment from a jira issue. it requires the ‘issueidorkey’ and ‘id’ parameters (with an optional ‘expand’ parameter) to fetch detailed information about a comment, including its content, author details, creation and update dates, and more. this action is essential for viewing and managing specific issue discussions in jira.
Action Parameters
Action Response
JIRA_GET_COMMENTS
This operation anonymously retrieves all comments from an issue. users need “browse projects” permission, issue-level security permission, and must belong to the right group or role if comments have visibility restrictions.
Action Parameters
Action Response
JIRA_GET_COMMENTS_BY_IDS
Fetches a paginated list of comments by id, accessible anonymously if the user has relevant project permissions, issue-level security access, and visibility group or role rights.
Action Parameters
Action Response
JIRA_GET_COMMENT_PROPERTY
Retrieves a comment’s value anonymously, needing ‘browse projects’ permission, issue-level security permission if set, and visibility group/role restrictions compliance if applied.
Action Parameters
Action Response
JIRA_GET_COMMENT_PROPERTY_KEYS
Retrieves all comment property keys; accessible anonymously with ‘browse projects’ permission, issue-level security permission if set, and visibility restrictions adherence if applicable.
Action Parameters
Action Response
JIRA_GET_COMPONENT
Returns a component. this operation can be accessed anonymously. permissions required: browse projects project permission for project containing the component.
Action Parameters
Action Response
JIRA_GET_COMPONENT_ISSUES_COUNT
The operation counts component-assigned issues and allows anonymous access. it will update oauth 2.0 scopes on june 15, 2024, requiring read:jira-work or granular permissions. no permissions needed currently.
Action Parameters
Action Response
JIRA_GET_CONTENTS_METADATA_FOR_AN_EXPANDED_ATTACHMENT
This operation extracts metadata from files within a zip attachment anonymously, ideal for backend use. it requires ‘browse projects’ permission and respects issue-level security. for comprehensive attachment metadata, use ‘get all metadata’.
Action Parameters
Action Response
JIRA_GET_CONTEXTS_FOR_A_FIELD
Deprecated api to get a paginated list of field contexts is replaced by “get custom field contexts.” admin rights required.
Action Parameters
Action Response
JIRA_GET_CREATE_FIELD_METADATA_FOR_A_PROJECT_AND_ISSUE_TYPE_ID
Retrieves field metadata for a project and issuetype to use in issue creation on atlassian. accessible anonymously with ‘create issues’ project permission needed.
Action Parameters
Action Response
JIRA_GET_CREATE_ISSUE_METADATA
Detailed project and issue type data for user requests in jira creation screens, now deprecated. information filters by query and accessible without login. requires project “create issues” permission. see deprecation notice for alternatives.
Action Parameters
Action Response
JIRA_GET_CREATE_METADATA_ISSUE_TYPES_FOR_A_PROJECT
This operation provides issue type metadata for a project to help with issue creation requests and can be used without login. create issues permission in the project is required.
Action Parameters
Action Response
JIRA_GET_CURRENT_USER
This tool retrieves detailed information about the currently authenticated user in jira. it is essential for verifying authentication, getting user-specific information, checking user permissions, retrieving preferences, and identifying the user for further api operations.
Action Parameters
Action Response
JIRA_GET_CUSTOM_FIELD_CONFIGURATIONS
Retrieve a paginated list of configurations for a forge app’s custom field type, filterable by id, fieldcontextid, issueid, or project/issue type. requires jira admin global permission.
Action Parameters
Action Response
JIRA_GET_CUSTOM_FIELD_CONTEXTS
Retrieve paginated custom field contexts from jira: get all, filter by ids, issue types, or project scope (global or limited). admin rights required.
Action Parameters
Action Response
JIRA_GET_CUSTOM_FIELD_CONTEXTS_DEFAULT_VALUES
Retrieve default settings for custom fields in jira, sorted by ‘contextid’. different fields like date or user picker have varying defaults. no defaults returned if none set. supports forge fields; ‘administer jira’ rights needed.
Action Parameters
Action Response
JIRA_GET_CUSTOM_FIELD_CONTEXTS_FOR_PROJECTS_AND_ISSUE_TYPES
Returns a paginated list of project-issue type mappings with applicable custom field context ids. if no specific context is assigned, a default one is used. duplicates aren’t allowed in the request. administer jira global permission is required.
Action Parameters
Action Response
JIRA_GET_CUSTOM_FIELD_OPTION
Retrieval of jira custom field options from select lists requires administer jira or browse projects permissions and is not for connect app fields. anonymous access allowed.
Action Parameters
Action Response
JIRA_GET_CUSTOM_FIELD_OPTIONS_CONTEXT
Returns a paginated list of custom field options, both normal and cascading, in display order for jira contexts. for connect app select list options, use specified issue custom field options operations. admin jira permissions required.
Action Parameters
Action Response
JIRA_GET_DASHBOARD
Anonymous users can access a dashboard. no permissions needed. to get a specific dashboard, it must be shared or owned by the user. ‘administer jira’ holders are deemed system dashboard owners, which is shared with all users.
Action Parameters
Action Response
JIRA_GET_DASHBOARD_ITEM_PROPERTY
The api allows users to customize app dashboard gadgets and provides item ids but lacks resource for item management. it supports anonymous access for owners or permitted users.
Action Parameters
Action Response
JIRA_GET_DASHBOARD_ITEM_PROPERTY_KEYS
This operation lists dashboard item keys and allows anonymous access. users must be owners or have shared access. administrators are deemed system dashboard owners, accessible to all if anonymous access in jira is allowed.
Action Parameters
Action Response
JIRA_GET_DATA_POLICY_FOR_PROJECTS_EAP
Returns data policies for the projects specified in the request.
Action Parameters
Action Response
JIRA_GET_DATA_POLICY_FOR_THE_WORKSPACE_EAP
Returns data policy for the workspace.
Action Parameters
Action Response
JIRA_GET_DEFAULT_ACTORS_FOR_PROJECT_ROLE
Returns the default actors for the project role. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_DEFAULT_WORKFLOW
In jira, the default workflow applies to unassigned issue types within a scheme. requires administer jira global permission.
Action Parameters
Action Response
JIRA_GET_DRAFT_DEFAULT_WORKFLOW
The default workflow for a jira workflow scheme draft assigns unmapped issue types to a specific workflow labeled all unassigned issue types. administering jira global permission is needed to access it.
Action Parameters
Action Response
JIRA_GET_DRAFT_WORKFLOW_SCHEME
Draft workflow schemes allow edits to active workflow schemes. when updated, a draft is made and modified; changes are then applied to the active scheme. only one draft per active scheme is allowed. admin rights required. more info on links provided.
Action Parameters
Action Response
JIRA_GET_DYNAMIC_WEBHOOKS_FOR_APP
Provides a paginated list of webhooks for the calling app, accessible only by connect and oauth 2.0 apps.
Action Parameters
Action Response
JIRA_GET_EDIT_ISSUE_METADATA
This endpoint shows user-accessible issue fields, factoring in availability, visibility, project context, and permissions. editability requires certain flags and permissions, with exceptions for fields like attachments. anonymous use is permitted.
Action Parameters
Action Response
JIRA_GET_EVENTS
Returns all issue events. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_FAILED_WEBHOOKS
Lists recently failed webhook delivery attempts to connect apps within 72 hours, using cursor pagination. returns oldest failure first; use failedafter or provided url for next page.
Action Parameters
Action Response
JIRA_GET_FAVORITE_FILTERS
Returns user’s visible favorite filters, including those owned, shared with their groups, their private/public projects, or the public. anonymous access allowed. filters not returned if access changes. (255 characters)
Action Parameters
Action Response
JIRA_GET_FIELDS
The system shows essential and globally-configured jira fields, plus additional ones if the user has permission. anonymous users can access without permissions.
Action Parameters
Action Response
JIRA_GET_FIELDS_IN_TRASH_PAGINATED
Retrieves a paginated list of trashed custom fields matching a string in name/description. requires ‘administer jira’ permission.
Action Parameters
Action Response
JIRA_GET_FIELDS_PAGINATED
Get a paginated list of classic jira project fields, including all fields, specific ones by id, or those with a string in their name or description using query. only “custom” type fields are searchable. requires jira admin permissions.
Action Parameters
Action Response
JIRA_GET_FIELD_AUTO_COMPLETE_SUGGESTIONS
Get jql autocomplete suggestions for a field by specifying fieldname, with optional fieldvalue, predicatename, and predicatevalue. anonymous access is available. no permissions required.
Action Parameters
Action Response
JIRA_GET_FIELD_CONFIGURATION_ISSUE_TYPE_ITEMS
Generates a paginated list of field config issues for classic projects. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_FIELD_CONFIGURATION_ITEMS
The text provides a link to a function that retrieves a paginated list of fields from classic company-managed project configurations, which requires jira admin global permissions.
Action Parameters
Action Response
JIRA_GET_FIELD_CONFIGURATION_SCHEMES_FOR_PROJECTS
Provides a sorted, paginated list of field configuration schemes for classic projects, including associated project ids, with the first item being the default. requires jira admin permissions.
Action Parameters
Action Response
JIRA_GET_FIELD_REFERENCE_DATA_GET
The document offers guidance on jql search data, covering fields, functions, and reserved words for crafting jql queries and recommends using post to filter fields per project. access to the operation is unrestricted.
Action Parameters
Action Response
JIRA_GET_FIELD_REFERENCE_DATA_POST
The text offers a guide for jql searches with field/function info, reserved words, custom field filters by project, and efficient use of collapsed fields, all without needing permissions.
Action Parameters
Action Response
JIRA_GET_FILTER
This operation anonymously returns a filter if it’s owned by the user, shared within their group or project, or is public. no permissions required.
Action Parameters
Action Response
JIRA_GET_GADGETS
The operation retrieves dashboard gadgets based on specified criteria: by list of ids, module key, list of uris, or all gadgets if no parameters are given. it can be accessed without any permissions.
Action Parameters
Action Response
JIRA_GET_GLOBAL_SETTINGS
Retrieves jira’s global settings to check enabled features like subtasks, time tracking; includes time tracking config if active. access permission required.
Action Parameters
Action Response
JIRA_GET_GROUP
Deprecated: to get group members, use group/member instead. requires “browse users and groups” or “administer jira” permissions.
Action Parameters
Action Response
JIRA_GET_IDS_OF_DELETED_WORKLOGS
Resource lists up to 1000 deleted worklog ids and timestamps after a specified date, with pagination using until and nextpage. excludes entries deleted in the last minute. jira access permission needed.
Action Parameters
Action Response
JIRA_GET_IDS_OF_UPDATED_WORKLOGS
Lists ids and timestamps of worklogs updated after a specific time, limited to 1000 per page and ordered by date. pagination available with until and nextpage. excludes last minute updates. viewing requires jira access and specific permissions.
Action Parameters
Action Response
JIRA_GET_ISSUE
This tool retrieves the details of a specific jira issue using the get /rest/api/3/issue/{issueidorkey} endpoint. it returns all relevant issue information, such as its summary, description, status, assignee, reporter, comments, attachments, and any custom fields configured in your jira instance.
Action Parameters
Action Response
JIRA_GET_ISSUE_FIELD_OPTION
This operation retrieves select list options from an issue field, but only for those added by connect apps. it won’t work with options made directly in jira. administer jira permission is needed, but not jira permissions for the app’s field.
Action Parameters
Action Response
JIRA_GET_ISSUE_LINK
Creates an issue link accessible anonymously, requiring ‘browse project’ permission for all linked issues and viewing permissions if issue-level security is set.
Action Parameters
Action Response
JIRA_GET_ISSUE_LINK_TYPE
Retrieves an issue link type from a site with issue linking enabled. anonymous access allowed. requires ‘browse projects’ permission for a project on the site.
Action Parameters
Action Response
JIRA_GET_ISSUE_LINK_TYPES
Fetches all issue link types if issue linking is active. accessible without login but requires ‘browse projects’ permission for any site project.
Action Parameters
Action Response
JIRA_GET_ISSUE_PICKER_SUGGESTIONS
Provides auto-complete suggestions for issues via two lists: history search with user’s past issues containing a query string, and current search with issues matching a jql expression and the query. accessible anonymously, no permissions needed.
Action Parameters
Action Response
JIRA_GET_ISSUE_PROPERTY
Returns the value of a property for an issue. this action makes a get request to the /rest/api/3/issue/{issueidorkey}/properties/{propertykey} endpoint and returns details including the key and value for the issue property. the operation can be accessed anonymously. permissions required: - browse projects project permission for the project containing the issue. - if issue-level security is configured, issue-level security permission to view the issue.
Action Parameters
Action Response
JIRA_GET_ISSUE_PROPERTY_KEYS
This operation provides urls and keys for an issue’s properties, available anonymously, but requires the user to have browse projects permission and, if applicable, issue-level security permission to view the details.
Action Parameters
Action Response
JIRA_GET_ISSUE_RESOLUTIONS
Returns a list of all issue resolution values. this tool retrieves all configured resolution types in the jira instance, providing details such as resolution ids, names, descriptions, and urls. it is useful for: - getting a list of available resolution types - finding the default resolution - obtaining resolution ids for other api calls - validating resolution names and ids before updating issues - understanding what options are available when closing issues
Action Parameters
Action Response
JIRA_GET_ISSUE_SECURITY_LEVEL
Summarizes issue security level details. ids can be found using the “get issue security scheme”. accessible anonymously with no permissions needed.
Action Parameters
Action Response
JIRA_GET_ISSUE_SECURITY_LEVELS
The service provides a paginated list of issue security levels for classic projects, with inclusive filtering by security scheme or level ids. jira administration permission is required.
Action Parameters
Action Response
JIRA_GET_ISSUE_SECURITY_LEVEL_MEMBERS
Provides a paginated list of issue security level members for classic projects. filtering by security scheme and level ids is possible. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_SECURITY_LEVEL_MEMBERS_BY_ISSUE_SECURITY_SCHEME
The text describes that only members with issue security levels from classic projects are returned. administering jira global permission is required for access.
Action Parameters
Action Response
JIRA_GET_ISSUE_SECURITY_SCHEME
The text describes that a user can retrieve an issue security scheme and its levels if they have “administer jira” global permission or “administer projects” permission for a project using the scheme.
Action Parameters
Action Response
JIRA_GET_ISSUE_SECURITY_SCHEMES
Returns all issue security schemes. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE
Operation returns an issue type and can be used without login. requires “browse projects” permission in the relevant project or “administer jira” global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPES_FOR_CUSTOM_FIELD_CONTEXT
Provides a paginated list of custom field context to issue type mappings, ordered by context and issue type ids. available for all or specific contexts. requires jira admin global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPES_FOR_PROJECT
This operation retrieves project issue types and can be used without login. required permissions: either “browse projects” in the project or “administer jira” globally.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPES_FOR_WORKFLOWS_IN_DRAFT_WORKFLOW_SCHEME
Returns the workflow-issue type mappings for a workflow scheme’s draft. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPES_FOR_WORKFLOWS_IN_WORKFLOW_SCHEME
Returns the workflow-issue type mappings for a workflow scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_PROPERTY
Access key and value of jira issue type property anonymously. requires ‘administer jira’ for any issue type, ‘browse projects’ for associated projects’ permissions.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_PROPERTY_KEYS
Get all issue type property keys; anonymous access allowed. requires ‘administer jira’ for any issue type; ‘browse projects’ for permitted projects.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_SCHEME
This tool retrieves detailed information about a specific issue type scheme in jira. an issue type scheme defines the mapping between issue types and projects. the action will return information about the scheme including its name, description, and the issue types associated with it.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_SCHEMES_FOR_PROJECTS
The text provides a link to access paginated lists of issue type schemes and their associated classic projects in jira. admin jira global permission is required for access.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_SCHEME_ITEMS
Get a paginated list of issue type scheme items for classic projects. requires the ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_SCREEN_SCHEMES
Retrieves a paginated list of issue type screen schemes for classic projects. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_SCREEN_SCHEMES_FOR_PROJECTS
Retrieves a paginated list of issue type screen schemes with their associated classic projects. requires jira admin global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_SCREEN_SCHEME_ITEMS
Retrieves a paginated list of issue type screen scheme items for classic projects. requires administer jira global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_TYPE_SCREEN_SCHEME_PROJECTS
Returns a paginated list of company-managed projects linked to an issue type screen scheme. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_ISSUE_WATCHERS
Gets the list of watchers for an issue. a watcher is a user who receives notifications when the issue is updated. this endpoint requires the ‘browse projects’ project permission for the project containing the issue. this operation requires the “allow users to watch issues” option to be on. this option is set in general configuration for jira.
Action Parameters
Action Response
JIRA_GET_ISSUE_WORKLOGS
Gets all work logs for an issue. the response includes details of all work logs for the issue that the user has permission to view. this action is essential for tracking time spent on issues and provides a comprehensive view of work logged against a specific issue, making it useful for project management, time tracking, and reporting purposes. permissions required: - browse projects project permission for the project that the issue is in. - if issue-level security is configured, issue-level security permission to view the issue. - if the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to.
Action Parameters
Action Response
JIRA_GET_IS_WATCHING_ISSUE_BULK
The feature checks if a user watches issues from a list; invalid ids return false. it requires “watch issues” permission, project browsing, and issue security access. details on jira config and permissions.
Action Parameters
Action Response
JIRA_GET_JIRA_ATTACHMENT_SETTINGS
The operation returns attachment settings, detailing if enabled and the size limit, with user restrictions set by project permissions. it’s accessible without login. no permissions required.
Action Parameters
Action Response
JIRA_GET_JIRA_INSTANCE_INFO
Returns information about the jira instance. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_LICENSE
Returns licensing information about the jira instance. permissions required: none.
Action Parameters
Action Response
JIRA_GET_LICENSED_PROJECT_TYPES
JIRA_GET_LOCALE
This resource returns a user’s locale in jira: if unset or anonymous, the detected browser locale via ‘accept-language’ header is used, falling back to jira’s default if no match is found. anonymous access is allowed; no permissions needed.
Action Parameters
Action Response
JIRA_GET_MODULES
Returns all modules registered dynamically by the calling app. permissions required: only connect apps can make this request.
Action Parameters
Action Response
JIRA_GET_MY_FILTERS
Fetches user’s owned filters; includes favorites if includefavourites is true. requires jira access permission. visibility depends on ownership, group membership, or project permissions. if a favorited public filter goes private, it won’t be returned.
Action Parameters
Action Response
JIRA_GET_MY_PERMISSIONS
Permissions vary by context (global, project, issue, comment) in a system; project rights can change with issue data. global permissions are constant, and some operations don’t require login or permissions.
Action Parameters
Action Response
JIRA_GET_NOTIFICATION_SCHEME
This text describes a notification scheme in jira that outlines events and their notification recipients. access requires jira permissions and project administration rights.
Action Parameters
Action Response
JIRA_GET_NOTIFICATION_SCHEMES_PAGINATED
Generates a paginated list of notification schemes, sorted by name, including those with no recipients. requires jira access and admin rights to a related project for scheme visibility.
Action Parameters
Action Response
JIRA_GET_PERMISSION_SCHEME
Returns a permission scheme. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_PERMISSION_SCHEME_GRANT
Returns a permission grant. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_PERMISSION_SCHEME_GRANTS
Returns all permission grants for a permission scheme. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_PERMITTED_PROJECTS
Returns all the projects where the user is granted a list of project permissions. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_PRECOMPUTATIONS_APPS
This api returns a list of a function’s precomputations, including creation, update, and last-used timestamps, and each has a jql fragment (value). access is exclusively for apps to inspect their own functions.
Action Parameters
Action Response
JIRA_GET_PREFERENCE
Retrieve user preferences using the user management rest api before 15/07/2024, as locale/timezone keys are deprecated. notification keys remain unaffected. permissions needed.
Action Parameters
Action Response
JIRA_GET_PRIORITIES
Returns the list of all issue priorities. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_PRIORITY
Returns an issue priority. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_PROJECT
This operation provides project details and is accessible even without logging in. however, one must have the ‘browse projects’ permission for the specific project to use it.
Action Parameters
Action Response
JIRA_GET_PROJECTS_PAGINATED
The operation provides a paginated list of projects a user can see, which can be accessed without login. visibility depends on having browse, administer projects permission, or administer jira global permission.
Action Parameters
Action Response
JIRA_GET_PROJECTS_USING_ISSUE_SECURITY_SCHEMES
Retrieve paginated list of projects with security schemes by filtering with scheme/project ids. if none provided, all mappings shown. for classic projects only; ‘administer jira’ rights needed.
Action Parameters
Action Response
JIRA_GET_PROJECTS_USING_NOTIFICATION_SCHEMES_PAGINATED
Generates a list of company-managed projects with their notification plans through pagination, filtering by id, or displaying all by default. limited to projects with default schemes, jira access needed.
Action Parameters
Action Response
JIRA_GET_PROJECT_CATEGORY_BY_ID
Returns a project category. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_PROJECT_COMPONENTS
The api returns all components in a project, offering a paginated list for projects with compass components. it’s accessible anonymously but requires ‘browse projects’ permission. for full pagination, refer to a specific resource.
Action Parameters
Action Response
JIRA_GET_PROJECT_COMPONENTS_PAGINATED
The api returns a paginated list of project components, including compass components linked to issues. anonymous access is supported if users have the ‘browse projects’ permission.
Action Parameters
Action Response
JIRA_GET_PROJECT_FEATURES
Returns the list of features for a project.
Action Parameters
Action Response
JIRA_GET_PROJECT_ISSUE_SECURITY_LEVELS
This operation lists project-specific issue security levels accessible to the user, anonymously available but requires ‘browse projects’ and ‘set issue security’ permissions for detailed access.
Action Parameters
Action Response
JIRA_GET_PROJECT_ISSUE_SECURITY_SCHEME
Summary: the text provides a link to the issue security scheme for a project and states that one needs either ‘administer jira’ global permission or ‘administer projects’ project permission to access it.
Action Parameters
Action Response
JIRA_GET_PROJECT_ISSUE_TYPE_HIERARCHY
A project’s issue hierarchy may have optional epics at top, standard issues like story/task/bug, and optional subtasks for breakdown. browsing the project requires permissions.
Action Parameters
Action Response
JIRA_GET_PROJECT_MAPPINGS_FOR_CUSTOM_FIELD_CONTEXT
The function provides a pageable list of mappings between context and projects for a custom field, filterable by contextid. requires the administer jira global permission. invalid ids are discarded.
Action Parameters
Action Response
JIRA_GET_PROJECT_NOTIFICATION_SCHEME
The text outlines that to access the project’s notification scheme, one needs either the ‘administer jira’ global permission or the ‘administer projects’ project permission.
Action Parameters
Action Response
JIRA_GET_PROJECT_PROPERTY
Retrieves the value of a jira project property, available even without authentication. requires ‘browse projects’ permission for the associated project.
Action Parameters
Action Response
JIRA_GET_PROJECT_PROPERTY_KEYS
This api endpoint retrieves all property keys for a project and is accessible without login. users need ‘browse projects’ permission for access.
Action Parameters
Action Response
JIRA_GET_PROJECT_ROLES_FOR_PROJECT
Jira cloud provides a list of project roles with names and urls, accessible even anonymously. roles are shared across projects. admin rights needed. see details and permission links online.
Action Parameters
Action Response
JIRA_GET_PROJECT_ROLE_BY_ID
The text provides a project role description and its default actors, sorted by display name, requiring ‘administer jira’ global permission for access.
Action Parameters
Action Response
JIRA_GET_PROJECT_ROLE_DETAILS
Fetches all common project roles and their details. can be accessed without login. requires ‘administer jira’ or ‘administer projects’ permissions.
Action Parameters
Action Response
JIRA_GET_PROJECT_ROLE_FOR_PROJECT
Retrieves project role details and associated actors, ordered by name. use ‘get user’ with ‘groups’ parameter to confirm user-role membership. anonymous access allowed. requires ‘administer projects’ or ‘administer jira’ permissions.
Action Parameters
Action Response
JIRA_GET_PROJECT_S_SENDER_EMAIL
Returns the project’s sender email address. permissions required: browse projects project permission for the project.
Action Parameters
Action Response
JIRA_GET_PROJECT_TYPE_BY_KEY
Returns a project type. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_PROJECT_VERSIONS
Action to get all versions in a specified jira project. this tool retrieves all versions in a specified jira project. it provides a comprehensive list of project versions with their details including version id, version name, release status, start and release dates, and description. requires ‘browse projects’ project permission.
Action Parameters
Action Response
JIRA_GET_PROJECT_VERSIONS_PAGINATED
Fetches a paginated list of project versions; for a full list without pagination, use the get project versions resource. anonymous access allowed but requires browse projects permission.
Action Parameters
Action Response
JIRA_GET_RECENT_PROJECTS
The feature shows up to 20 recent projects visible to the user, accessible anonymously with appropriate permissions to browse, administer the project, or administer jira.
Action Parameters
Action Response
JIRA_GET_REMOTE_ISSUE_LINKS
Gets the remote issue links for a jira issue. this operation requires the link issue permission. it retrieves external remote links associated with a jira issue, with the ability to filter by issue key and global id. permissions required: - browse projects project permission for the project that the issue is in. - if issue-level security is configured, issue-level security permission to view the issue.
Action Parameters
Action Response
JIRA_GET_REMOTE_ISSUE_LINK_BY_ID
The operation fetches a remote issue link, requires active issue linking, and can be anonymous. permissions needed: ‘browse projects’ for the issue’s project and issue-level security if configured.
Action Parameters
Action Response
JIRA_GET_REQUIRED_STATUS_MAPPINGS_FOR_WORKFLOW_SCHEME_UPDATE
The text outlines how to get status mappings for updating workflow schemes in jira, specifying that permissions such as ‘administer jira’ and ‘administer projects’ are required for updates.
Action Parameters
Action Response
JIRA_GET_RESOLUTION
Returns an issue resolution value. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_RESOLUTIONS
Returns a list of all issue resolution values. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_SCREENS
Retrieves a paginated list of screens, filterable by specific screen ids. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_SCREENS_FOR_A_FIELD
Returns a paginated list of the screens a field is used in. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_SCREEN_SCHEMES
Fetches a paginated list of screen schemes for classic projects, requiring the administer jira global permission.
Action Parameters
Action Response
JIRA_GET_SELECTABLE_ISSUE_FIELD_OPTIONS
Provides a paginated list of select list issue field options from connect apps, not usable with jira-native options. requires jira access permissions.
Action Parameters
Action Response
JIRA_GET_SELECTED_TIME_TRACKING_PROVIDER
The current time tracking provider is returned; if disabled, an empty response is given. administer jira global permission is required.
Action Parameters
Action Response
JIRA_GET_STATUS
The operation retrieves a status linked to an active workflow, prioritizing the first status found if multiple have the same name. status can be fetched by id for specificity. no permissions needed; anonymous access allowed.
Action Parameters
Action Response
JIRA_GET_STATUS_CATEGORY
Returns a status category. status categories provided a mechanism for categorizing statuses. permissions required: permission to access jira.
Action Parameters
Action Response
JIRA_GET_SYSTEM_AVATARS_BY_TYPE
Returns a list of system avatar details by owner type, where the owner types are issue type, project, or user. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_GET_TASK
This operation checks the status of a long-running async task, returning a json result when completed, retaining details for 14 days. oauth scopes update on june 15, 2024. requires admin permission or task creator access.
Action Parameters
Action Response
JIRA_GET_THE_DEFAULT_DATA_CLASSIFICATION_LEVEL_OF_A_PROJECT
The text outlines that to return the default data classification for a project, one needs browse projects and administer projects permissions for the project, as well as administer jira global permission.
Action Parameters
Action Response
JIRA_GET_TIME_TRACKING_SETTINGS
Retrieves time tracking configurations like format and units. requires ‘administer jira’ global permission. more details: [configuring time tracking] and [permissions].
Action Parameters
Action Response
JIRA_GET_TRANSITIONS
This tool returns all transitions or a specific transition for an issue based on its status. it helps in determining available status changes and understanding what workflow transitions (including required screens and conditions) are available for an issue.
Action Parameters
Action Response
JIRA_GET_UI_MODIFICATIONS
Gets ui modifications. ui modifications can only be retrieved by forge apps. permissions required: none.
Action Parameters
Action Response
JIRA_GET_USER
User data is returned with respect to privacy settings, possibly concealing the email. more info on profile visibility and required “browse users and groups” global permission is available online.
Action Parameters
Action Response
JIRA_GET_USERS_FROM_GROUP
The service provides a paginated list of users in a group, sorted by username (which is not shown for privacy), with required permissions being “browse users and groups” or “administer jira.”
Action Parameters
Action Response
JIRA_GET_USER_DEFAULT_COLUMNS
Returns the default issue table columns for a user. if no accountid is provided, the caller’s details are returned. admin rights are needed to retrieve any user’s details; jira access is required for one’s own details.
Action Parameters
Action Response
JIRA_GET_USER_EMAIL
Returns a user’s email address. this api is only available to apps approved by atlassian, according to these guidelines.
Action Parameters
Action Response
JIRA_GET_USER_EMAIL_BULK
Returns a user’s email address. this api is only available to apps approved by atlassian, according to these guidelines.
Action Parameters
Action Response
JIRA_GET_USER_GROUPS
Returns the groups to which a user belongs. permissions required: browse users and groups global permission.
Action Parameters
Action Response
JIRA_GET_USER_PROPERTY
Returns a user’s property value; if no key is provided, it lists available keys. does not access jira user properties. requires administer jira permission for others’ properties, or user access for own.
Action Parameters
Action Response
JIRA_GET_USER_PROPERTY_KEYS
This function retrieves all property keys for a user but excludes jira-specific user properties. admin global permission is required for any user’s keys, while jira access is needed for one’s own keys.
Action Parameters
Action Response
JIRA_GET_VALID_PROJECT_KEY
Validates a project key and, if the key is invalid or in use, generates a valid random string for the project key. permissions required: none.
Action Parameters
Action Response
JIRA_GET_VALID_PROJECT_NAME
Validates project name availability, returning the original or a modified version with a sequence number. if a valid name can’t be created, a 404 error is issued. no permissions required.
Action Parameters
Action Response
JIRA_GET_VERSION
This operation retrieves a project version and is publicly accessible. however, browsing the project containing the version necessitates the “browse projects” permission.
Action Parameters
Action Response
JIRA_GET_VERSION_S_UNRESOLVED_ISSUES_COUNT
This operation provides the number of total and unresolved issues in a project version, is available without login, and requires ‘browse projects’ permission.
Action Parameters
Action Response
JIRA_GET_VISIBLE_ISSUE_FIELD_OPTIONS
Retrieves a user-viewable, paginated list of select list issue field options from connect apps only, not those created in jira or via the issue custom field options resource. jira access is required.
Action Parameters
Action Response
JIRA_GET_VOTES
This tool retrieves voting information for a specified issue in jira. it returns details about the number of votes an issue has received and the users who have voted on it. it is used to get vote details, including the vote count, whether the current user has voted, and details about the voters. note: this operation requires the “allow users to vote on issues” option to be enabled in jira settings. users without the “view voters and watchers” project permission won’t see details in the voters field. permissions required: - browse projects project permission - if issue-level security is configured, issue-level security permission to view the issue
Action Parameters
Action Response
JIRA_GET_WORKFLOWS_PAGINATED
Fetches a paginated list of classic workflows, detailing specified names or all published ones; excludes next-gen workflows. requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_GET_WORKFLOW_FOR_ISSUE_TYPE_IN_DRAFT_WORKFLOW_SCHEME
Returns the issue type-workflow mapping for an issue type in a workflow scheme’s draft. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_WORKFLOW_FOR_ISSUE_TYPE_IN_WORKFLOW_SCHEME
Returns the issue type-workflow mapping for an issue type in a workflow scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_WORKFLOW_SCHEME
Returns a workflow scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_GET_WORKFLOW_SCHEME_PROJECT_ASSOCIATIONS
Generates a list of workflow schemes linked to projects, detailing project associations per scheme. team-managed/non-existent projects are excluded silently. no id for projects using ‘default workflow scheme’. admin rights required.
Action Parameters
Action Response
JIRA_GET_WORKFLOW_TRANSITION_PROPERTIES
The text describes how transition properties affect workflow transitions in jira, linking to related resources. admin rights are necessary to make changes.
Action Parameters
Action Response
JIRA_GET_WORKFLOW_TRANSITION_RULE_CONFIGURATIONS
Get a filtered, paginated list of workflows with transition rules created by connect or forge apps. can be refined by rule types or keys. some workflows with no rules might appear due to server optimizations. only available to connect/forge apps.
Action Parameters
Action Response
JIRA_GET_WORKLOG
Returns all work logs for an issue. the endpoint provides detailed information about each work log including time spent, the author, and work timestamps. it is useful for tracking time spent on issues, generating time reports, auditing work on issues, project management, resource allocation, and billing purposes. permissions required: - browse projects project permission - if issue-level security is configured, issue-level security permission to view the issue - if the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to
Action Parameters
Action Response
JIRA_GET_WORKLOGS
The service returns up to 1000 worklog details for specified ids. access requires jira permissions, and worklogs are shown if they’re public or if the user has viewing rights through a project role or group.
Action Parameters
Action Response
JIRA_GET_WORKLOG_PROPERTY
Fetches a worklog property value. anonymous access allowed. requires ‘browse projects’ permission, issue security permission if set, and worklog visibility group/role access.
Action Parameters
Action Response
JIRA_GET_WORKLOG_PROPERTY_KEYS
This operation, which can be accessed anonymously, returns worklog property keys but requires ‘browse projects’ permission for the issue’s project, issue-level security permission if applicable, and visibility restriction compliance.
Action Parameters
Action Response
JIRA_JIRA_EDIT_ISSUE
This action edits an existing issue in jira. it accepts parameters such as issueidorkey, fields, update, notifyusers, overridescreensecurity, and overrideeditableflag. the action handles field validation, permission checks, screen and workflow validations, and error handling, and returns a 204 status when the issue is updated successfully.
Action Parameters
Action Response
JIRA_JIRA_GET_ISSUE_TYPES
Returns all issue types visible to the user. this tool retrieves a list of all issue types visible to the user, including custom issue types, sub-task issue types, and standard issue types. it is essential for determining available issue types for creating new issues and for retrieving issue type metadata for project configuration. permissions required: - if the user has the “administer jira” global permission, all issue types are returned. - if the user has the “browse projects” project permission for one or more projects, only the issue types associated with those projects are returned.
Action Parameters
Action Response
JIRA_LIST_BOARDS
This tool retrieves all boards that the authenticated user has permission to view. it supports optional parameters (startat, maxresults, type, name, projectkeyorid, includeprivate, orderby) to filter and paginate the results.
Action Parameters
Action Response
JIRA_LIST_ISSUE_COMMENTS
This tool retrieves all comments for a specific jira issue. it accepts a required parameter ‘issueidorkey’ along with optional parameters for pagination and sorting. the response includes an array of comment objects containing details like author info, comment body, timestamps, and visibility settings.
Action Parameters
Action Response
JIRA_LIST_SPRINTS
This tool retrieves all sprints from a specified board and returns them in order of start date, with the most recent sprint appearing first. it supports parameters such as board id (required), state (optional), start at (optional, default: 0), and max results (optional, default: 50) for pagination.
Action Parameters
Action Response
JIRA_MAP_ISSUE_TYPES_TO_SCHEME_WORKFLOWS
Assign issue types to workflows within a scheme, setting a default workflow for unmapped types. active schemes require updatedraftifneeded set to true to edit. admin rights needed.
Action Parameters
Action Response
JIRA_MERGE_VERSIONS
Merges two project versions by deleting one and updating references to it. alternative solution and permissions required are detailed. accessible anonymously.
Action Parameters
Action Response
JIRA_MOVE_CUSTOM_FIELD_TO_TRASH
Deletes a custom field in jira to trash; admin rights needed. see guides for further details on deletion processes. edit/delete info, permissions.
Action Parameters
Action Response
JIRA_MOVE_ISSUE_TO_SPRINT
This tool moves one or more jira issues to a specific sprint. the sprint must be active or open to receive issues. it accepts a sprint id and an array of issue keys (up to 50 issues per operation).
Action Parameters
Action Response
JIRA_MOVE_PRIORITIES
Changes the order of issue priorities. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_MOVE_RESOLUTIONS
Changes the order of issue resolutions. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_MOVE_SCREEN_TAB
Moves a screen tab. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_MOVE_SCREEN_TAB_FIELD
Moves a screen tab field. if after and position are provided in the request, position is ignored. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_MOVE_VERSION
The text describes a feature that changes the order of version sequences in a jira project, which is available anonymously but requires ‘browse projects’ permission for the relevant project.
Action Parameters
Action Response
JIRA_PARSE_JQL_QUERY
Parses and validates jql queries. validation is performed in context of the current user. this operation can be accessed anonymously. permissions required: none.
Action Parameters
Action Response
JIRA_PARTIAL_UPDATE_PROJECT_ROLE
Operation updates either a project role’s name or description, not both. only the name is changed if both are provided. administer jira global permission is required.
Action Parameters
Action Response
JIRA_PUBLISH_DRAFT_WORKFLOW_SCHEME
A draft workflow scheme with new statuses for issue types is published. issue status updates are mapped accordingly. the process is asynchronous; track status via provided links. admin jira rights needed.
Action Parameters
Action Response
JIRA_REGISTER_DYNAMIC_WEBHOOKS
Webhooks are set for oauth apps; they work if the app owner is the webhook registrar. only connect and oauth 2.0 apps have the necessary permissions to operate this.
Action Parameters
Action Response
JIRA_REGISTER_MODULES
Registers a list of modules. permissions required: only connect apps can make this request.
Action Parameters
Action Response
JIRA_REMOVE_CUSTOM_FIELD_CONTEXT_FROM_PROJECTS
Removing projects from a custom field context makes it apply to all projects. if a project isn’t in the context or causes duplicate global contexts, the operation fails. admin rights are required.
Action Parameters
Action Response
JIRA_REMOVE_FILTER_AS_FAVORITE
This function allows a user to remove a filter from their favorites. if a favorited public filter becomes private and invisible, it can’t be unfavored. access to jira is required.
Action Parameters
Action Response
JIRA_REMOVE_GADGET_FROM_DASHBOARD
Removes a dashboard gadget from a dashboard. when a gadget is removed from a dashboard, other gadgets in the same column are moved up to fill the emptied position. permissions required: none.
Action Parameters
Action Response
JIRA_REMOVE_GROUP
Deletes a group. permissions required: site administration (that is, member of the site-admin strategic group).
Action Parameters
Action Response
JIRA_REMOVE_ISSUE_SECURITY_LEVEL
Removes an issue security level asynchronously. check the task status via the ‘location’ link, and get updates using ‘get task’. admin jira global permission needed.
Action Parameters
Action Response
JIRA_REMOVE_ISSUE_TYPES_FROM_CONTEXT
Summary: admins with “administer jira” global permission can remove issue types from a custom field context, making it applicable to all issue types.
Action Parameters
Action Response
JIRA_REMOVE_ISSUE_TYPES_FROM_FIELD_CONFIGURATION_SCHEME
This operation removes issue types from field configuration schemes in classic projects and requires ‘administer jira’ global permissions.
Action Parameters
Action Response
JIRA_REMOVE_ISSUE_TYPE_FROM_ISSUE_TYPE_SCHEME
This operation deletes an issue type from a scheme but can’t remove types in use, from the default scheme, or the last in a scheme. admin rights needed.
Action Parameters
Action Response
JIRA_REMOVE_MAPPINGS_FROM_ISSUE_TYPE_SCREEN_SCHEME
Removes issue type to screen scheme mappings from an issue type screen scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_REMOVE_MEMBER_FROM_ISSUE_SECURITY_LEVEL
Removes an issue security level member from an issue security scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_REMOVE_MODULES
Remove all or a list of modules registered by the calling app. permissions required: only connect apps can make this request.
Action Parameters
Action Response
JIRA_REMOVE_NOTIFICATION_FROM_NOTIFICATION_SCHEME
Removes a notification from a notification scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_REMOVE_SCREEN_TAB_FIELD
Removes a field from a screen tab. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_REMOVE_THE_DEFAULT_DATA_CLASSIFICATION_LEVEL_FROM_A_PROJECT
To remove a project’s default data classification level, users need ‘administer projects’ project permission and ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_REMOVE_USER_FROM_GROUP
Removes a user from a group. permissions required: site administration (that is, member of the site-admin group).
Action Parameters
Action Response
JIRA_REMOVE_WATCHER_FROM_ISSUE
Removes a user from an issue’s list of watchers. this operation requires the user to have permission to view the issue and to manage the issue’s watchers. permissions required: - browse projects project permission for the project that the issue is in. - if issue-level security is configured, issue-level security permission to view the issue. - to remove users other than themselves from the watchlist, manage watcher list project permission for the project that the issue is in.
Action Parameters
Action Response
JIRA_REORDER_CUSTOM_FIELD_OPTIONS_CONTEXT
This operation allows reordering of jira custom field options. for connect app fields, use “issue custom field options (apps)” operations. administer jira global permission is required.
Action Parameters
Action Response
JIRA_REPLACE_CUSTOM_FIELD_OPTIONS
This operation updates custom field options for select lists in jira, but not for options from connect/forge apps. admin jira permissions are required.
Action Parameters
Action Response
JIRA_REPLACE_ISSUE_FIELD_OPTION
De-select and replace select-list options on issues via jql query. only for options added by connect apps. requires administer jira permission to override security. asynchronous operation with a task link provided. not for jira-native field options.
Action Parameters
Action Response
JIRA_RESET_COLUMNS
Reset filter column settings to default for filters owned by the user, those in shared groups, private projects with browse permission, public projects, and public filters. permission to access jira required.
Action Parameters
Action Response
JIRA_RESET_USER_DEFAULT_COLUMNS
Resets user’s default issue table columns to system default; if no accountid specified, affects caller’s defaults. administer jira rights needed to alter any user’s columns, jira access required for self-reset.
Action Parameters
Action Response
JIRA_RESTORE_CUSTOM_FIELD_FROM_TRASH
Restores a deleted custom field in jira, requiring ‘administer jira’ global permission. for details on deleting custom fields, visit provided links.
Action Parameters
Action Response
JIRA_RESTORE_DELETED_OR_ARCHIVED_PROJECT
Revives archived or recycled jira projects. requires ‘administer jira’ for company-managed or ‘administer jira’/‘administer projects’ for team-managed projects.
Action Parameters
Action Response
JIRA_RETRIEVE_THE_ATTRIBUTES_OF_SERVICE_REGISTRIES
Retrieve the attributes of given service registries. permissions required: only connect apps can make this request and the servicesids belong to the tenant you are requesting
Action Parameters
Action Response
JIRA_SANITIZE_JQL_QUERIES
The system transforms jql queries to use entity ids for privacy when users don’t have access, altering clauses with restricted projects, but it’s not gdpr compliant without admin rights.
Action Parameters
Action Response
JIRA_SEARCH_FOR_DASHBOARDS
Access a filtered, paginated list of dashboards with specific attributes. anonymous users can view public dashboards; logged-in users see more, based on ownership, group, and project access.
Action Parameters
Action Response
JIRA_SEARCH_FOR_FILTERS
Retrieve a paginated list of filters anonymously. filters can be fetched by ‘id’ or by matching multiple attributes. results are limited to filters owned, shared with user’s group or project, or public filters. no specific permissions needed.
Action Parameters
Action Response
JIRA_SEARCH_FOR_ISSUES_USING_JQL_GET
This tool allows searching for jira issues using jql (jira query language) queries. it provides a flexible way to search and filter issues based on various criteria, including pagination and custom field selection.
Action Parameters
Action Response
JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST
This tool allows searching for jira issues using jql (jira query language) queries via post request. this endpoint is particularly useful for handling complex queries that exceed url length limits, supports additional parameters like startat, maxresults, fields, expand, validatequery, and properties, and provides enhanced flexibility for batch operations and paginated responses.
Action Parameters
Action Response
JIRA_SEARCH_ISSUE_IDS_USING_JQL
Use jql to find issue ids. for more data, use the search endpoint, which is slower. anonymous access is allowed. required permissions are ‘browse projects’ and, if applicable, ‘issue-level security’.
Action Parameters
Action Response
JIRA_SEARCH_ISSUE_SECURITY_SCHEMES
Get a paginated list of issue security schemes, filterable by project id. use a specific method to find all projects associated with a scheme. only for classic projects and requires jira admin permission.
Action Parameters
Action Response
JIRA_SEARCH_PRIORITIES
The service returns a paginated list of jira priorities, filterable by priority ids, project ids, and default field configurations for company-managed projects. inaccessible or invalid ids are ignored. jira access permission is required.
Action Parameters
Action Response
JIRA_SEARCH_RESOLUTIONS
Returns a paginated list of resolutions from company-managed projects in jira, filterable by resolution ids and default field configurations. access requires jira permissions.
Action Parameters
Action Response
JIRA_SEARCH_STATUSES_PAGINATED
The api returns a paginated list of statuses based on name or project searches. requires ‘administer projects’ and ‘administer jira’ permissions.
Action Parameters
Action Response
JIRA_SELECT_TIME_TRACKING_PROVIDER
Selects a time tracking provider. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_SEND_NOTIFICATION_FOR_ISSUE
This tool sends email notifications for a specific jira issue. it allows users to create customized email notifications that will be added to the mail queue and sent to specified recipients. it includes parameters to specify the issue id or key, subject, text body, optional html body, and recipient details. this tool is useful for automating notification workflows and ensuring that relevant stakeholders are informed of important issue updates.
Action Parameters
Action Response
JIRA_SET_ACTORS_FOR_PROJECT_ROLE
Assigns new actors to a project role, replacing current actors. use a different option to add without replacing. requires project admin or jira admin permissions.
Action Parameters
Action Response
JIRA_SET_APPLICATION_PROPERTY
Jira allows changing application properties, such as the clone prefix and date formats, with default values listed. advanced settings affect jira’s look and functionality, and should be altered with caution by jira admins.
Action Parameters
Action Response
JIRA_SET_APP_PROPERTY
Stores custom data for an app using a non-empty json value up to 32768 characters. only connect apps with matching addonkey or forge apps can access these properties.
Action Parameters
Action Response
JIRA_SET_APP_PROPERTY_FORGE
Assigns a forge app property that can be accessed in jira expressions. app context variable for retrieval. use storage api otherwise. request body must be valid, non-empty json under 32768 chars. only forge apps have permissions.
Action Parameters
Action Response
JIRA_SET_COLUMNS
Use put with form data to set columns for a jira filter. only ‘navigable’ fields allowed, fetched using ‘get fields’. restricted to filters owned by the user, their groups, or projects they have permissions for.
Action Parameters
Action Response
JIRA_SET_COMMENT_PROPERTY
Set custom data on a comment by sending a valid, non-empty json under 32,768 characters. requires permissions to “edit all comments” or “edit own comments,” with additional role/group membership if the comment is restricted.
Action Parameters
Action Response
JIRA_SET_CUSTOM_FIELD_CONTEXTS_DEFAULT_VALUES
Sets default values for custom fields in contexts like date, options, and forge types. one default per request; set to null to unset. admin rights needed.
Action Parameters
Action Response
JIRA_SET_DASHBOARD_ITEM_PROPERTY
Apps can add custom data gadgets to user dashboards, with a 32,768 character limit for json data, and controls for content and settings. dashboard ownership or admin rights are needed for access.
Action Parameters
Action Response
JIRA_SET_DEFAULT_ISSUE_SECURITY_LEVELS
Sets default issue security levels for schemes. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_SET_DEFAULT_PRIORITY
Sets default issue priority. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_SET_DEFAULT_RESOLUTION
Sets default issue resolution. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_SET_ISSUE_PROPERTY
This resource allows storing custom data on an issue with a valid json blob up to 32,768 characters, even anonymously. requires ‘browse projects’ and ‘edit issues’ permissions, plus issue-level security access if set.
Action Parameters
Action Response
JIRA_SET_ISSUE_TYPES_FOR_WORKFLOW_IN_WORKFLOW_SCHEME
Workflow scheme draft in jira can have issue types set and a default workflow assigned. unassigned issue types default to this workflow. admin permissions are required.
Action Parameters
Action Response
JIRA_SET_ISSUE_TYPE_PROPERTY
This api endpoint allows updating or creating a property for a jira issue type with a valid json blob up to 32768 characters. administer jira global permission is required.
Action Parameters
Action Response
JIRA_SET_LOCALE
Use the user management rest api’s “update a user profile” to set user locale in jira; ensure appropriate permissions.
Action Parameters
Action Response
JIRA_SET_PREFERENCE
The text covers how to set/update user/system preferences, like notifications and shortcuts, within a 255-character limit. old locale/timezone settings default to a new api that requires permissions.
Action Parameters
Action Response
JIRA_SET_PROJECT_AVATAR
Use “load project avatar” to upload project avatars, then apply this operation to choose the displayed one. administer projects permission is necessary.
Action Parameters
Action Response
JIRA_SET_PROJECT_FEATURE_STATE
Sets the state of a project feature.
Action Parameters
Action Response
JIRA_SET_PROJECT_PROPERTY
Stores custom data in a project property on jira using a valid json blob (up to 32,768 chars). accessible anonymously but requires ‘administer jira’ or ‘administer projects’ permissions.
Action Parameters
Action Response
JIRA_SET_PROJECT_S_SENDER_EMAIL
Configures the project’s email sender address; an empty ‘emailaddress’ resets to default. requires ‘administer jira’ or ‘administer projects’ permissions.
Action Parameters
Action Response
JIRA_SET_TIME_TRACKING_SETTINGS
Sets the time tracking settings. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_SET_USER_DEFAULT_COLUMNS
Sets user’s default issue table columns in jira. without an account id, it affects the caller’s settings. if no columns are specified, defaults are cleared. admins can set any user’s columns; others can only set their own. data is sent as html form data.
Action Parameters
Action Response
JIRA_SET_USER_PROPERTY
This resource allows for setting custom user data. it doesn’t affect jira user properties. admin rights are needed to modify any user, while self-edit requires jira access.
Action Parameters
Action Response
JIRA_SET_WORKFLOW_FOR_ISSUE_TYPE_IN_DRAFT_WORKFLOW_SCHEME
Sets the workflow for an issue type in a workflow scheme’s draft. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_SET_WORKFLOW_FOR_ISSUE_TYPE_IN_WORKFLOW_SCHEME
To modify an active workflow scheme’s issue type in jira, set ‘updatedraftifneeded’ to ‘true’ to create/update a draft. publish the draft to apply changes. admin permissions required.
Action Parameters
Action Response
JIRA_SET_WORKLOG_PROPERTY
Store custom data in a worklog by setting a property with a valid json blob, up to 32768 characters. anonymous access allowed. requires ‘browse projects’ and ‘edit worklogs’ permissions, and adherence to issue-level security if set.
Action Parameters
Action Response
JIRA_TRANSITION_ISSUE
This operation transitions an issue, updates its fields if a screen is present, and requires certain permissions. use ‘fields’ in the request to specify updates. it’s accessible anonymously, but project and issue-level permissions are needed.
Action Parameters
Action Response
JIRA_UNARCHIVE_ISSUE_S_BY_ISSUE_KEYS_ID
Admins can unarchive up to 1000 issues per request from specific jira projects; details and errors are provided. no subtask direct unarchival. jira or site admin rights and premium/enterprise license needed. no anonymous access.
Action Parameters
Action Response
JIRA_UPDATE_ANNOUNCEMENT_BANNER_CONFIGURATION
Updates the announcement banner configuration. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_COMMENT
This tool updates an existing comment on a jira issue. it requires permissions such as ‘browse projects’, ‘edit all comments’ or ‘edit own comments’, and appropriate visibility permissions if restrictions apply.
Action Parameters
Action Response
JIRA_UPDATE_COMPONENT
Operation updates a component, overwrites given fields, and can unset lead with empty leadaccountid. anonymous access permitted. needs administer projects or administer jira permissions.
Action Parameters
Action Response
JIRA_UPDATE_CUSTOM_FIELD
Updates a custom field. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_CUSTOM_FIELDS
Updates unique combinations of custom fields on issues. restricted to only the app that declared those fields and requires app ownership for updates.
Action Parameters
Action Response
JIRA_UPDATE_CUSTOM_FIELD_CONFIGURATIONS
Update a forge app’s custom field settings in jira with “administer jira” global permission; the forge app itself doesn’t need jira permissions.
Action Parameters
Action Response
JIRA_UPDATE_CUSTOM_FIELD_CONTEXT
The text provides instructions for updating a jira custom field context and specifies that the user must have the ‘administer jira’ global permission to do so.
Action Parameters
Action Response
JIRA_UPDATE_CUSTOM_FIELD_OPTIONS_CONTEXT
Updating custom field options in jira only applies to select list options made in jira or via its api. updates ignore unchanged values and omit them in the response. requires jira admin permissions. connect app options can’t be updated this way.
Action Parameters
Action Response
JIRA_UPDATE_CUSTOM_FIELD_VALUE
Apps can update the value of their own declared custom fields for issues but only if they have the necessary permissions as the operation is restricted to the app that owns the fields.
Action Parameters
Action Response
JIRA_UPDATE_DASHBOARD
Updates a dashboard, replacing all the dashboard details with those provided. permissions required: none the dashboard to be updated must be owned by the user.
Action Parameters
Action Response
JIRA_UPDATE_DEFAULT_WORKFLOW
Changes the default workflow in a scheme; active ones need updatedraftifneeded set to true to edit. creates/updates a draft workflow scheme in jira for publishing. admin rights required.
Action Parameters
Action Response
JIRA_UPDATE_DRAFT_DEFAULT_WORKFLOW
Sets the default workflow for a workflow scheme’s draft. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_DRAFT_WORKFLOW_SCHEME
Updates or creates a draft workflow scheme for an existing active workflow. each active scheme can only have one draft. administer jira global permission required.
Action Parameters
Action Response
JIRA_UPDATE_FIELD_CONFIGURATION
This operation updates a field configuration’s name and description for company-managed projects and requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_UPDATE_FIELD_CONFIGURATION_ITEMS
Updates, and restricts, field configurations in classic projects; sets text/wiki renderers but excludes autocomplete. admin rights required.
Action Parameters
Action Response
JIRA_UPDATE_FIELD_CONFIGURATION_SCHEME
This operation updates field configuration schemes for classic projects in jira and requires ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_UPDATE_FILTER
Updates a filter. use this operation to update a filter’s name, description, jql, or sharing. permissions required: permission to access jira, however the user must own the filter.
Action Parameters
Action Response
JIRA_UPDATE_GADGET_ON_DASHBOARD
Changes the title, position, and color of the gadget on a dashboard. permissions required: none.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_FIELD_OPTION
Update or create select list options for an issue field in connect apps by providing an identical option id in both path and body. admin rights needed; not for jira-built issue fields.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_LINK_TYPE
This operation updates an issue link type in jira, requiring the site to have issue linking enabled and the user to have the ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_SECURITY_LEVEL
Updates the issue security level. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_SECURITY_SCHEME
Updates the issue security scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_TYPE
Updates the issue type. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_TYPE_SCHEME
Updates an issue type scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_TYPE_SCREEN_SCHEME
Updates an issue type screen scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_ISSUE_TYPE_SCREEN_SCHEME_DEFAULT_SCREEN_SCHEME
Updates the default screen scheme in an issue type screen scheme for all issue types not individually mapped. requires administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_NOTIFICATION_SCHEME
Updates a notification scheme. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_PERMISSION_SCHEME
Updating a permission scheme either changes its name/description or replaces all grants with a given list; an empty list removes all grants. specific endpoints handle individual grant changes. admin rights are needed.
Action Parameters
Action Response
JIRA_UPDATE_PRECOMPUTATIONS_APPS
Update the precomputation value of a function created by a forge/connect app. permissions required: an api for apps to update their own precomputations.
Action Parameters
Action Response
JIRA_UPDATE_PRIORITY
Updates an issue priority. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_PROJECT
Updated project details via a request with optional parameters; schemes update only when included. admin jira global permission needed for schemes or project key changes; otherwise, admin projects permission suffices.
Action Parameters
Action Response
JIRA_UPDATE_PROJECT_CATEGORY
Updates a project category. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_REMOTE_ISSUE_LINK_BY_ID
The text describes updating a remote issue link, where unset fields default to null. it requires active issue linking and can be done anonymously but needs ‘browse projects’ and ‘link issues’ permissions and potentially issue-level security permissions.
Action Parameters
Action Response
JIRA_UPDATE_RESOLUTION
Updates an issue resolution. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_SCREEN
Updates a screen. only screens used in classic projects can be updated. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_SCREEN_SCHEME
Updates a screen scheme. only screen schemes used in classic projects can be updated. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_SCREEN_TAB
Updates the name of a screen tab. permissions required: administer jira global permission.
Action Parameters
Action Response
JIRA_UPDATE_THE_DEFAULT_DATA_CLASSIFICATION_LEVEL_OF_A_PROJECT
Updated project’s default data classification level; requires ‘administer projects’ project permission and ‘administer jira’ global permission.
Action Parameters
Action Response
JIRA_UPDATE_UI_MODIFICATION
Forge apps can update ui modifications, each with up to 1,000 contexts; a single context can be used in up to 100 such modifications. no permissions needed if no context is set; ‘browse projects’ permission required for context-specific modifications.
Action Parameters
Action Response
JIRA_UPDATE_VERSION
This operation updates a project version and can be done anonymously. it requires either “administer jira” global permission or “administer projects” project permission for the relevant project.
Action Parameters
Action Response
JIRA_UPDATE_WORKFLOW_SCHEME
This api updates workflow schemes in company and team projects instantly; changes in issue statuses trigger issue migrations. admin permissions are required for updates.
Action Parameters
Action Response
JIRA_UPDATE_WORKFLOW_TRANSITION_PROPERTY
Updating a workflow transition modifies an existing property or adds a new one if it’s not present, altering the transition’s behavior. administer jira global permission is required. more info on transition and workflow properties is available online.
Action Parameters
Action Response
JIRA_UPDATE_WORKFLOW_TRANSITION_RULE_CONFIGURATIONS
Jira now allows the creator app (connect or forge) to update workflow transition rules, such as post functions, conditions, validators, disable rules, and add tags, with default enabled status and restricted to authorized apps.
Action Parameters
Action Response
JIRA_UPDATE_WORKLOG
Update jira worklog by enabling time tracking, checking permissions (project browsing, issue security viewing, worklog editing), adhering to visibility rules. anonymous edits allowed. for setup, see the time tracking configuration guide.
Action Parameters
Action Response
JIRA_VALIDATE_CREATE_WORKFLOWS
To bulk create workflows in jira, you need ‘administer jira’ permission for global workflows and ‘administer projects’ for project-specific ones.
Action Parameters
Action Response
JIRA_VALIDATE_PROJECT_KEY
Validates a project key by confirming the key is a valid string and not in use. permissions required: none.
Action Parameters
Action Response
JIRA_VALIDATE_UPDATE_WORKFLOWS
To bulk update workflows, you need “administer jira” permission for global workflows and “administer projects” for project-specific ones.
Action Parameters
Action Response