Atlassian Issues API

The Issues API from Atlassian — 32 operation(s) for issues.

Documentation GitHub OpenAPI

Business capability

Operations 20

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /rest/api/3/events List all Jira issue event types · Atlassian Get Events #

Ask an LLM

“What issue events does Jira fire, like issue created or issue resolved?”

“Which event types can I hook notifications onto in my Jira site?”

Tell an agent

List every issue event type defined in Jira.

Show me the IDs and names of all Jira issue events.

POST /rest/api/3/issue Create a Jira issue or subtask · Atlassian Create Issue #

Ask an LLM

“How do I create a single new issue in Jira through the API?”

“Can I open a subtask and move it straight to a non-default workflow step when I create it?”

Tell an agent

Create a new issue with these field values: {fields}.

Open a single ticket with {fields} and apply transition {transition} on creation.

POST /rest/api/3/issue/archive Archive up to 100,000 issues matching a JQL query · Atlassian Archive Issue S By Jql #

Ask an LLM

“Can I archive every issue that matches a JQL search in one go?”

“How many issues can a JQL-based archive request handle, and how do I track its progress?”

Tell an agent

Archive all issues matching the JQL {jql}.

Start a background archive job for every ticket returned by {jql}.

PUT /rest/api/3/issue/archive Archive up to 1,000 issues by ID or key · Atlassian Archive Issue S By Issue Id Key #

Ask an LLM

“Can an admin archive a specific list of issues by their keys?”

“What is the limit on how many issues I can archive by key in one request?”

Tell an agent

Archive the issues {issueIdsOrKeys}.

Archive these specific tickets by key and report any errors: {issueIdsOrKeys}.

POST /rest/api/3/issue/bulk Bulk create up to 50 issues · Atlassian Bulk Create Issue #

Ask an LLM

“Can I create many Jira issues in a single request?”

“What is the maximum number of issues a bulk create call accepts?”

Tell an agent

Bulk create these issues in one request: {issueUpdates}.

Create a batch of up to 50 tickets from {issueUpdates}.

GET /rest/api/3/issue/createmeta Get create-screen metadata across projects · Atlassian Get Create Issue Metadata #

Ask an LLM

“Which projects and issue types am I allowed to create issues in?”

“What fields appear on the create screen for issue types across several projects?”

Tell an agent

Show the create issue metadata for projects {projectKeys}.

Get create-screen fields for issue types {issuetypeNames} in projects {projectKeys}, expanding {expand}.

GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes List creatable issue types for a project · Atlassian Get Create Metadata Issue Types For A Project #

Ask an LLM

“What issue types can I create in a given project?”

“Is there a paged list of issue type metadata for one project's create screen?”

Tell an agent

List the issue types I can create in project {projectIdOrKey}.

Show the first {maxResults} creatable issue types for project {projectIdOrKey}.

GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId} Get create fields for a project issue type · Atlassian Get Create Field Metadata For A Project And Issue Type Id #

Ask an LLM

“Which fields are required when creating a particular issue type in a project?”

“What does the create screen look like for a bug type in one specific project?”

Tell an agent

Get the create fields for issue type {issueTypeId} in project {projectIdOrKey}.

List required and optional create fields for type {issueTypeId} in {projectIdOrKey}, starting at {startAt}.

PUT /rest/api/3/issue/unarchive Restore archived issues by ID or key · Atlassian Unarchive Issue S By Issue Keys Id #

Ask an LLM

“How do I bring archived Jira issues back?”

“Can I unarchive up to a thousand issues at once by key?”

Tell an agent

Unarchive the issues {issueIdsOrKeys}.

Restore these archived tickets: {issueIdsOrKeys}.

DELETE /rest/api/3/issue/{issueIdOrKey} Delete an issue · Atlassian Delete Issue #

Ask an LLM

“How do I permanently delete a Jira issue?”

“Can I delete an issue that still has subtasks under it?”

Tell an agent destructive · confirm first

Delete issue {issueIdOrKey}.

Delete ticket {issueIdOrKey} along with its subtasks ({deleteSubtasks}).

GET /rest/api/3/issue/{issueIdOrKey} Get the details of an issue · Atlassian Get Issue #

Ask an LLM

“What is the current status and assignee of a given ticket?”

“Can I fetch only selected fields of an issue instead of everything?”

Tell an agent

Show me issue {issueIdOrKey}.

Get only the fields {fields} for ticket {issueIdOrKey}.

PUT /rest/api/3/issue/{issueIdOrKey} Edit an existing issue's fields · Atlassian Edit Issue #

Ask an LLM

“How do I change the fields on an issue that already exists?”

“Can I edit a ticket without emailing all of its watchers?”

Tell an agent

Update issue {issueIdOrKey} with {fields}.

Edit ticket {issueIdOrKey} to set {fields} and don't notify watchers ({notifyUsers}).

PUT /rest/api/3/issue/{issueIdOrKey}/assignee Assign an issue to a user · Atlassian Assign Issue #

Ask an LLM

“Can I assign a ticket to someone if I only have the Assign issue permission?”

“What happens if I assign an issue without giving an account ID?”

Tell an agent

Assign issue {issueIdOrKey} to user {accountId}.

Make {accountId} the assignee of {issueIdOrKey}.

GET /rest/api/3/issue/{issueIdOrKey}/changelog List the change history of an issue · Atlassian Get Changelogs #

Ask an LLM

“Who changed what on a ticket, and when, from oldest to newest?”

“Can I page through the full history of edits on an issue?”

Tell an agent

Show the changelog for issue {issueIdOrKey}.

List {maxResults} history entries for {issueIdOrKey} starting at {startAt}.

POST /rest/api/3/issue/{issueIdOrKey}/changelog/list Get specific changelog entries of an issue · Atlassian Get Changelogs By Ids #

Ask an LLM

“Can I look up particular changelog entries by their IDs rather than the whole history?”

“What exactly changed in a known set of history records on a ticket?”

Tell an agent

Get changelogs {changelogIds} for issue {issueIdOrKey}.

Fetch only these history records {changelogIds} from {issueIdOrKey}.

GET /rest/api/3/issue/{issueIdOrKey}/editmeta Get the editable fields for an issue · Atlassian Get Edit Issue Metadata #

Ask an LLM

“Which fields on an existing ticket am I allowed to edit?”

“Can I see hidden or non-editable fields on an issue's edit screen?”

Tell an agent

Show the edit screen fields for issue {issueIdOrKey}.

List editable fields for {issueIdOrKey}, including hidden ones ({overrideScreenSecurity}).

POST /rest/api/3/issue/{issueIdOrKey}/notify Send an email notification about an issue · Atlassian Send Notification For Issue #

Ask an LLM

“Can I email people about a ticket with a custom subject and body?”

“Is it possible to restrict an issue notification to users with certain permissions?”

Tell an agent

Email {to} about issue {issueIdOrKey} with subject {subject}.

Send a notification for {issueIdOrKey} with the message {textBody}.

GET /rest/api/3/issue/{issueIdOrKey}/transitions List the transitions available on an issue · Atlassian Get Transitions #

Ask an LLM

“What status changes can I make on a ticket right now?”

“Can I see transitions that are currently blocked by a condition?”

Tell an agent

List the available transitions for issue {issueIdOrKey}.

Check whether transition {transitionId} can be performed on {issueIdOrKey}.

POST /rest/api/3/issue/{issueIdOrKey}/transitions Move an issue through a workflow transition · Atlassian Transition Issue #

Ask an LLM

“How do I move a ticket from In Progress to Done?”

“Can I fill in transition screen fields while changing an issue's status?”

Tell an agent

Transition issue {issueIdOrKey} using {transition}.

Apply transition {transition} to {issueIdOrKey} and set {fields} on the transition screen.

PUT /rest/api/3/issues/archive/export Export archived issues to a CSV by email · Atlassian Export Archived Issue S #

Ask an LLM

“Can I get a CSV of all the issues that have been archived?”

“Which archived issues did a particular person archive within a date range?”

Tell an agent

Export archived issues from projects {projects} to CSV.

Email me a CSV of issues archived by {archivedBy} during {archivedDateRange}.

Atlassian Issues API

Operations 20

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification