Skip to main content

​
Before you begin

Make sure you have:

​
Connect your Jira account

1

Open Integrations

Go to Potpie → Integrations.
2

Authorize Jira

Click Connect Jira and complete the OAuth consent screen on Atlassian’s side. Potpie stores your access and refresh tokens encrypted in PostgreSQL, linked to your Jira Cloud organization.
Once connected, agents can use Jira tools whenever they are included in the agent’s tool list.

​
What agents can do with Jira

Each tool below becomes available to any agent that has it included in its tool list. All tools require an active Jira connection — if none is found, the tool returns an error prompting you to connect Jira first. Reading issues
​
get_jira_issue_tool
tool
Fetches a single issue by key. Returns summary, status, assignee, priority, labels, and description.
​
search_jira_issues_tool
tool
Searches issues using JQL with pagination support. Use this to find issues by project, status, assignee, or any JQL expression.
Creating and updating issues
​
create_jira_issue_tool
tool
Creates a new issue with summary, description, type, priority, assignee, and labels. Requires a valid project key.
​
update_jira_issue_tool
tool
Updates one or more fields on an existing issue. Pass only the fields you want to change — unchanged fields are left as-is.
​
add_jira_comment_tool
tool
Posts a comment to an existing issue. Useful for logging agent actions or adding context to issues without modifying their fields.
​
transition_jira_issue_tool
tool
Moves an issue through its workflow by transition name (e.g. "In Progress", "Done"). Use get_jira_project_details_tool first to retrieve valid transitions for the project.
​
link_jira_issues_tool
tool
Links two issues using a relationship type such as Blocks, Relates to, or Duplicates.
Project and user discovery
​
get_jira_projects_tool
tool
Lists all Jira projects accessible to the connected account.
​
get_jira_project_details_tool
tool
Returns valid issue types, priorities, and statuses for a specific project. Call this before creating or transitioning issues to ensure you’re passing valid values.
​
get_jira_project_users_tool
tool
Lists users who can be assigned to issues in a given project.

​
Token refresh

Potpie automatically refreshes your Jira access token before it expires. No action is required from you — agents will continue working without interruption across token cycles.

​
Webhooks

At connection time, Potpie registers a webhook on your Jira Cloud site that subscribes to the following events:
  • Issue created
  • Issue updated
  • Issue deleted
  • Comment added
All incoming webhook events are verified using a signed JWT before processing. This ensures Potpie only acts on events originating from your Jira organization.