Skip to main content

Jira

A connector to the Jira software.

What you can ask​

  • Find every Jira issue assigned to me with status In progress and a due date in the past.
  • Create a sub-task under PROJ-1247 for each acceptance criterion in this story.
  • Move all stale In review tickets older than 14 days into Backlog.

Set up​

Jira needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Jira. Click Enable, and choose which tools to allow.
  2. In the Atlassian developer console, choose Create, then OAuth 2.0 integration, and name the app after your organization.
  3. Under Permissions, add the Jira API and grant these scopes: View Jira issue data, Manage project settings, Manage Jira global settings, View user profiles, and Create and manage issues. Atlassian rejects the consent screen if scopes are missing.
  4. Under Distribution, set the status to Sharing, use your own name as the vendor, fill in the privacy policy, terms of service, and support contact, and set Personal data declaration to No.
  5. Under Authorization, configure OAuth 2.0 (3LO) with the exact callback URL shown in the connector settings.
  6. Copy the client ID and secret from the app's Settings page into the connector, then save it.
  7. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Jira login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (11)

Grant the scopes for the tools you plan to allow.

  • manage:jira-configuration
  • manage:jira-project
  • read:board-scope:jira-software
  • read:issue-details:jira
  • read:jira-user
  • read:jira-work
  • read:project:jira
  • read:sprint:jira-software
  • write:board-scope:jira-software
  • write:jira-work
  • write:sprint:jira-software

Tools​

Jira offers 48 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (30)​

View and search information without changing it.

ToolWhat it does
discover_issue_required_fieldsDiscover required fields for Jira issue creation.
get_active_sprintGet the active sprint for a Jira project by project key.
get_attachment_contentRead a Jira attachment: content_base64, plus extracted_text for PDF, DOCX and text files (logs, stack traces); check extraction_status.
get_attachment_thumbnailGet the small preview Jira generates for an image attachment, as content_base64.
get_boardGet Jira board details.
get_board_sprintsList sprints for board.
get_boardsList all Jira boards.
get_commentsGet comments for a Jira issue
get_current_userGet the current authenticated user
get_issueGet Jira issue details using the issue key
get_issue_attachmentsList an issue's attachments: attachment ID, filename, size, MIME type, author, created date.
get_issue_transitionsGet available transitions for a Jira issue
get_move_task_progressCheck progress of bulk move operation.
get_prioritiesGet all available priorities.
get_projectGet a specific Jira project by key or ID
get_project_componentsGet all components for a Jira project.
get_project_issue_typesGet issue types for a specific project
get_project_statusesGet workflow statuses available for a specific project.
get_project_templatesGet template keys for project type.
get_project_versionsGet versions for a specific project
get_projectsSearch and filter Jira projects.
get_sprintGet sprint details.
get_userGet a specific Jira user by account ID or username
get_user_assignee_suggestionsGet user assignee suggestions for an issue or project
get_user_groupsGet groups that a user belongs to
get_worklogsGet worklog entries for a Jira issue
list_statusesList all workflow statuses in Jira.
search_issuesSearch Jira issues using JQL or structured filters.
search_usersSearch for Jira users.
validate_credentialValidate Jira credentials.

Write (7)​

Create or send data.

ToolWhat it does
add_attachmentAdd an attachment to a Jira issue.
add_commentAdd a comment to a Jira issue.
add_worklogLog work on a Jira issue.
create_boardCreate Jira board (scrum/kanban).
create_issueCreate a Jira issue.
create_projectCreate Jira project.
link_issuesLink two Jira issues.

Delete or overwrite (11)​

Remove or replace existing data.

ToolWhat it does
delete_attachmentDelete an attachment by ID.
delete_commentDelete a comment from a Jira issue
delete_issueDelete a Jira issue
delete_projectDelete a Jira project.
move_issues_between_projectsMove issues between projects.
move_issues_to_backlogMove issues to backlog.
move_issues_to_sprintMove issues to sprint.
transition_issueTransition a Jira issue to a new status.
update_commentReplace the body of an existing Jira comment.
update_issueUpdate a Jira issue.
update_projectUpdate a Jira project.
⌘J