Jira

Jira Projects API

Manage Jira projects including metadata, roles, and components.

GitHub OpenAPI
Business capability
Project Management BC-900.30

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://artifacts.apis.io/jira/openapi/jira-projects-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/jira/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"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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://artifacts.apis.io/jira/openapi/jira-projects-api-openapi.yml