Jira

Jira Projects API

Manage Jira projects including metadata, roles, and components.

GitHub OpenAPI

Operations 17

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 /project List all visible projects via the unversioned path · Jira Get All Projects #
Ask an LLM
“Is there an older unversioned /project endpoint that returns every project at once?”
“Can the legacy unpaginated project list include only recently viewed projects?”
Tell an agent
Call the legacy unversioned /project endpoint to list every project I can see.
Using the unversioned /project path, list projects with recent set to {recent} and expand {expand}.
GET /project/search Page through projects via the unversioned search path · Jira Get Projects Paginated #
Ask an LLM
“Does the unversioned /project/search path let me filter projects by type or category?”
“Can I page through projects on the older search path without the /rest/api/3 prefix?”
Tell an agent
Search projects matching {query} using the unversioned /project/search path.
On the unversioned /project/search path, list projects of type {typeKey} in category {categoryId}.
GET /project/{projectIdOrKey} Get a project's details via the unversioned path · Jira Get Project #
Ask an LLM
“Can I fetch a project's issue types and components from the legacy unversioned project path?”
“Does the older project lookup without the /rest/api/3 prefix still return versions and roles?”
Tell an agent
Get project {projectIdOrKey} from the unversioned /project path.
Using the legacy unversioned path, fetch project {projectIdOrKey} expanded with {expand}.
GET /project/{projectIdOrKey}/statuses List a project's statuses via the unversioned path · Jira Get All Statuses for Project #
Ask an LLM
“Does the legacy unversioned statuses path group a project's statuses by issue type?”
“Is there an older project statuses endpoint outside /rest/api/3 that I can still call?”
Tell an agent
List statuses for project {projectIdOrKey} using the unversioned /project path.
Via the legacy path without /rest/api/3, show the valid statuses per issue type in project {projectIdOrKey}.
GET /rest/api/3/project List every project I can see in one response · Get all projects #
Ask an LLM
“How do I get every Jira project visible to me in a single unpaginated call?”
“Is the deprecated get-all-projects call on /rest/api/3 still able to include project properties?”
Tell an agent
List all projects visible to me using the deprecated /rest/api/3/project call.
Get the full unpaginated project list from /rest/api/3/project including properties {properties}.
POST /rest/api/3/project Create a new project from a template · Create project #
Ask an LLM
“How do I create a new Jira project with a key and a name?”
“Can I pick a project template and type when creating a project?”
Tell an agent
Create a project named {name} with key {key}.
Create project {name} with key {key} from template {projectTemplateKey}, led by {leadAccountId}.
GET /rest/api/3/project/recent List projects I viewed recently · Get recent projects #
Ask an LLM
“Which projects have I looked at recently?”
“What are the up to 20 projects I viewed most recently?”
Tell an agent
Show my recently viewed projects.
List the projects I've viewed lately, expanded with {expand}.
GET /rest/api/3/project/search Search and page through projects · Get projects paginated #
Ask an LLM
“How do I search for projects by name or key with pagination?”
“Can I find only archived or deleted projects?”
Tell an agent
Search projects whose name or key contains {query}.
Find projects with keys {keys}, ordered by {orderBy}.
DELETE /rest/api/3/project/{projectIdOrKey} Delete a project · Delete project #
Ask an LLM
“Can I delete a project but keep the option to undo it?”
“Why can't I delete a project that has been archived?”
Tell an agent destructive · confirm first
Delete project {projectIdOrKey}.
Delete project {projectIdOrKey} with undo set to {enableUndo}.
GET /rest/api/3/project/{projectIdOrKey} Get a project's details · Get project #
Ask an LLM
“What issue types, components and versions does a project have?”
“Can I look up a project by its key instead of its ID?”
Tell an agent
Get the details of project {projectIdOrKey}.
Show project {projectIdOrKey} including properties {properties}.
PUT /rest/api/3/project/{projectIdOrKey} Update a project's details or schemes · Update project #
Ask an LLM
“How do I change a project's name or lead?”
“Can I swap the permission or notification scheme on an existing project?”
Tell an agent
Rename project {projectIdOrKey} to {name}.
Make {leadAccountId} the lead of project {projectIdOrKey}.
POST /rest/api/3/project/{projectIdOrKey}/archive Archive a project · Archive project #
Ask an LLM
“How do I archive a project that's no longer active?”
“What happens if I try to delete a project after archiving it?”
Tell an agent
Archive project {projectIdOrKey}.
Move project {projectIdOrKey} into the archive.
POST /rest/api/3/project/{projectIdOrKey}/delete Delete a project as a background task · Delete project asynchronously #
Ask an LLM
“Can I delete a large project as a transactional background task?”
“Where do I track the progress of an asynchronous project deletion?”
Tell an agent destructive · confirm first
Delete project {projectIdOrKey} asynchronously and give me the task link.
Start a background deletion of project {projectIdOrKey}.
POST /rest/api/3/project/{projectIdOrKey}/restore Restore an archived or deleted project · Restore deleted or archived project #
Ask an LLM
“How do I bring back a project from the recycle bin?”
“Can I unarchive a project through the API?”
Tell an agent
Restore project {projectIdOrKey}.
Bring archived project {projectIdOrKey} back into use.
GET /rest/api/3/project/{projectIdOrKey}/statuses List valid statuses for each issue type in a project · Get all statuses for project #
Ask an LLM
“What statuses can issues move through in a given project?”
“Which statuses apply to each issue type in my project?”
Tell an agent
List the statuses for project {projectIdOrKey}, grouped by issue type.
Show which statuses each issue type can have in project {projectIdOrKey}.
GET /rest/api/3/project/{projectId}/hierarchy Get a next-gen project's issue type hierarchy · Get project issue type hierarchy #
Ask an LLM
“How are epics, stories and subtasks layered in a team-managed project?”
“What issue type levels exist in a next-gen project?”
Tell an agent
Get the issue type hierarchy for project {projectId}.
Show the epic, standard and subtask levels in next-gen project {projectId}.
GET /rest/api/3/project/{projectKeyOrId}/notificationscheme Get the notification scheme a project uses · Get project notification scheme #
Ask an LLM
“Which notification scheme is attached to my project?”
“Who gets emailed about events in a project, per its notification scheme?”
Tell an agent
Get the notification scheme for project {projectKeyOrId}.
Show project {projectKeyOrId}'s notification scheme expanded with {expand}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
RateLimits
https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
📖
GettingStarted
https://developer.atlassian.com/cloud/jira/platform/getting-started/
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
GettingStarted
https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
📖
Authentication
https://developer.atlassian.com/cloud/jira/software/security-overview/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-projects-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/asyncapi/jira-webhooks-asyncapi.yml

Code Examples

💻
CodeExamples
https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples

Other Resources

🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/platform/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/platform/security-overview/
🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/software/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/software/security-overview/
🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/service-desk/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/service-desk/security-overview/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-projects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-projects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Jira Projects API
  x-refined-note:
  - x-atlassian-api-version differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Projects across 2 of this provider''s published API definitions: jira-cloud-platform-rest-api-openapi.yml, jira-platform-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{domain}.atlassian.net/rest/api/3
  description: Jira Cloud instance
  variables:
    domain:
      description: Your Jira Cloud site subdomain (e.g., your-company).
      default: your-domain
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (177 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-projects-api-openapi.yml