Jira

Interact with Jira

Jira is a leading project management and issue tracking platform that helps teams plan, track, and manage agile software development projects effectively. As part of the Atlassian suite, Jira has become the industry standard for software development teams and project management professionals worldwide.

Jira provides a comprehensive set of tools for managing complex projects through its flexible and customizable workflow system. With its robust API and integration capabilities, Jira enables teams to streamline their development processes and maintain clear visibility of project progress.

Key features of Jira include:

Agile Project Management: Support for Scrum and Kanban methodologies with customizable boards and workflows
Issue Tracking: Sophisticated tracking system for bugs, stories, epics, and tasks with detailed reporting
Workflow Automation: Powerful automation rules to streamline repetitive tasks and processes
Advanced Search: JQL (Jira Query Language) for complex issue filtering and reporting

In Sim, the Jira integration allows your agents to seamlessly interact with your project management workflow. This creates opportunities for automated issue creation, updates, and tracking as part of your AI workflows. The integration enables agents to create, retrieve, and update Jira issues programmatically, facilitating automated project management tasks and ensuring that important information is properly tracked and documented. By connecting Sim with Jira, you can build intelligent agents that maintain project visibility while automating routine project management tasks, enhancing team productivity and ensuring consistent project tracking.

Usage Instructions

Integrate Jira into the workflow. Can read, write, and update issues. Can also trigger workflows based on Jira webhook events.

Tools

`jira_retrieve`

Retrieve detailed information about a specific Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`projectId`	string	No	Jira project ID (optional; not required to retrieve a single issue).
`issueKey`	string	Yes	Jira issue key to retrieve (e.g., PROJ-123)
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Jira issue details with issue key, summary, description, created and updated timestamps

`jira_update`

Update a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`projectId`	string	No	Jira project ID to update issues in. If not provided, all issues will be retrieved.
`issueKey`	string	Yes	Jira issue key to update
`summary`	string	No	New summary for the issue
`description`	string	No	New description for the issue
`status`	string	No	New status for the issue
`priority`	string	No	New priority for the issue
`assignee`	string	No	New assignee for the issue
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Updated Jira issue details with timestamp, issue key, summary, and success status

`jira_write`

Write a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`projectId`	string	Yes	Project ID for the issue
`summary`	string	Yes	Summary for the issue
`description`	string	No	Description for the issue
`priority`	string	No	Priority for the issue
`assignee`	string	No	Assignee for the issue
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.
`issueType`	string	Yes	Type of issue to create (e.g., Task, Story)

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Created Jira issue details with timestamp, issue key, summary, success status, and URL

`jira_bulk_read`

Retrieve multiple Jira issues in bulk

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`projectId`	string	Yes	Jira project ID
`cloudId`	string	No	Jira cloud ID

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	array	Array of Jira issues with summary, description, created and updated timestamps

`jira_delete_issue`

Delete a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to delete (e.g., PROJ-123)
`deleteSubtasks`	boolean	No	Whether to delete subtasks. If false, parent issues with subtasks cannot be deleted.
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Deleted issue details with timestamp, issue key, and success status

`jira_assign_issue`

Assign a Jira issue to a user

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to assign (e.g., PROJ-123)
`accountId`	string	Yes	Account ID of the user to assign the issue to. Use "-1" for automatic assignment or null to unassign.
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Assignment details with timestamp, issue key, assignee ID, and success status

`jira_transition_issue`

Move a Jira issue between workflow statuses (e.g., To Do -> In Progress)

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to transition (e.g., PROJ-123)
`transitionId`	string	Yes	ID of the transition to execute (e.g., "11" for "To Do", "21" for "In Progress")
`comment`	string	No	Optional comment to add when transitioning the issue
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Transition details with timestamp, issue key, transition ID, and success status

`jira_search_issues`

Search for Jira issues using JQL (Jira Query Language)

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`jql`	string	Yes	JQL query string to search for issues (e.g., "project = PROJ AND status = Open")
`startAt`	number	No	The index of the first result to return (for pagination)
`maxResults`	number	No	Maximum number of results to return (default: 50)
`fields`	array	No	Array of field names to return (default: ['summary', 'status', 'assignee', 'created', 'updated'])
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Search results with timestamp, total count, pagination details, and array of matching issues

`jira_add_comment`

Add a comment to a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to add comment to (e.g., PROJ-123)
`body`	string	Yes	Comment body text
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Comment details with timestamp, issue key, comment ID, body, and success status

`jira_get_comments`

Get all comments from a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to get comments from (e.g., PROJ-123)
`startAt`	number	No	Index of the first comment to return (default: 0)
`maxResults`	number	No	Maximum number of comments to return (default: 50)
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Comments data with timestamp, issue key, total count, and array of comments

`jira_update_comment`

Update an existing comment on a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key containing the comment (e.g., PROJ-123)
`commentId`	string	Yes	ID of the comment to update
`body`	string	Yes	Updated comment text
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Updated comment details with timestamp, issue key, comment ID, body text, and success status

`jira_delete_comment`

Delete a comment from a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key containing the comment (e.g., PROJ-123)
`commentId`	string	Yes	ID of the comment to delete
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Deletion details with timestamp, issue key, comment ID, and success status

`jira_get_attachments`

Get all attachments from a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to get attachments from (e.g., PROJ-123)
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Attachments data with timestamp, issue key, and array of attachments

`jira_delete_attachment`

Delete an attachment from a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`attachmentId`	string	Yes	ID of the attachment to delete
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Deletion details with timestamp, attachment ID, and success status

`jira_add_worklog`

Add a time tracking worklog entry to a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to add worklog to (e.g., PROJ-123)
`timeSpentSeconds`	number	Yes	Time spent in seconds
`comment`	string	No	Optional comment for the worklog entry
`started`	string	No	Optional start time in ISO format (defaults to current time)
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Worklog details with timestamp, issue key, worklog ID, time spent in seconds, and success status

`jira_get_worklogs`

Get all worklog entries from a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to get worklogs from (e.g., PROJ-123)
`startAt`	number	No	Index of the first worklog to return (default: 0)
`maxResults`	number	No	Maximum number of worklogs to return (default: 50)
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Worklogs data with timestamp, issue key, total count, and array of worklogs

`jira_update_worklog`

Update an existing worklog entry on a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key containing the worklog (e.g., PROJ-123)
`worklogId`	string	Yes	ID of the worklog entry to update
`timeSpentSeconds`	number	No	Time spent in seconds
`comment`	string	No	Optional comment for the worklog entry
`started`	string	No	Optional start time in ISO format
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Worklog update details with timestamp, issue key, worklog ID, and success status

`jira_delete_worklog`

Delete a worklog entry from a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key containing the worklog (e.g., PROJ-123)
`worklogId`	string	Yes	ID of the worklog entry to delete
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Deletion details with timestamp, issue key, worklog ID, and success status

`jira_create_issue_link`

Create a link relationship between two Jira issues

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`inwardIssueKey`	string	Yes	Jira issue key for the inward issue (e.g., PROJ-123)
`outwardIssueKey`	string	Yes	Jira issue key for the outward issue (e.g., PROJ-456)
`linkType`	string	Yes	The type of link relationship (e.g., "Blocks", "Relates to", "Duplicates")
`comment`	string	No	Optional comment to add to the issue link
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Issue link details with timestamp, inward issue key, outward issue key, link type, and success status

`jira_delete_issue_link`

Delete a link between two Jira issues

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`linkId`	string	Yes	ID of the issue link to delete
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Deletion details with timestamp, link ID, and success status

`jira_add_watcher`

Add a watcher to a Jira issue to receive notifications about updates

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to add watcher to (e.g., PROJ-123)
`accountId`	string	Yes	Account ID of the user to add as watcher
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Watcher details with timestamp, issue key, watcher account ID, and success status

`jira_remove_watcher`

Remove a watcher from a Jira issue

Input

Parameter	Type	Required	Description
`domain`	string	Yes	Your Jira domain (e.g., yourcompany.atlassian.net)
`issueKey`	string	Yes	Jira issue key to remove watcher from (e.g., PROJ-123)
`accountId`	string	Yes	Account ID of the user to remove as watcher
`cloudId`	string	No	Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Removal details with timestamp, issue key, watcher account ID, and success status

Notes

Category: tools
Type: jira

On this page

On this page

Start building today

Trusted by over 60,000 builders.

Build Agentic workflows visually on a drag-and-drop canvas or with natural language.