Jira

Jira Teams in plan API

This resource represents planning settings for plan-only and Atlassian teams in a plan. Use it to get, create, update and delete planning settings.

GitHub OpenAPI

Operations 9

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/plans/plan/{planId}/team List teams in a plan · Get teams in plan paginated #
Ask an LLM
“Which teams are part of a Jira plan?”
“Does a plan's team list include both plan-only and Atlassian teams?”
Tell an agent
List the teams in plan {planId}.
Show the next page of teams in plan {planId} from cursor {cursor}.
POST /rest/api/3/plans/plan/{planId}/team/atlassian Add an Atlassian team to a plan · Add Atlassian team to plan #
Ask an LLM
“Can I bring an existing Atlassian team into a plan with a scrum or kanban planning style?”
“What planning settings can I set when adding a team to a plan?”
Tell an agent
Add Atlassian team {id} to plan {planId} with planning style {planningStyle}.
Add team {id} to plan {planId} as {planningStyle} with capacity {capacity}.
DELETE /rest/api/3/plans/plan/{planId}/team/atlassian/{atlassianTeamId} Remove an Atlassian team from a plan · Remove Atlassian team from plan #
Ask an LLM
“Can I take an Atlassian team out of a plan?”
“Are a team's planning settings lost when it's removed from a plan?”
Tell an agent destructive · confirm first
Remove Atlassian team {atlassianTeamId} from plan {planId}.
Take Atlassian team {atlassianTeamId} out of plan {planId} and drop its settings.
GET /rest/api/3/plans/plan/{planId}/team/atlassian/{atlassianTeamId} Get an Atlassian team's plan settings · Get Atlassian team in plan #
Ask an LLM
“What capacity and sprint length is an Atlassian team configured with in a plan?”
“Can I see one shared team's planning settings?”
Tell an agent
Get the planning settings for Atlassian team {atlassianTeamId} in plan {planId}.
Show Atlassian team {atlassianTeamId}'s capacity in plan {planId}.
PUT /rest/api/3/plans/plan/{planId}/team/atlassian/{atlassianTeamId} Update an Atlassian team's plan settings · Update Atlassian team in plan #
Ask an LLM
“Can I change an Atlassian team's capacity or sprint length in a plan?”
“Which planning settings of a shared team can be patched?”
Tell an agent
Update Atlassian team {atlassianTeamId}'s planning settings in plan {planId}.
Change the sprint length for Atlassian team {atlassianTeamId} in plan {planId}.
POST /rest/api/3/plans/plan/{planId}/team/planonly Create a plan-only team · Create plan-only team #
Ask an LLM
“How do I create a team that exists only inside one plan?”
“Can I add members when creating a plan-only team?”
Tell an agent
Create plan-only team {name} in plan {planId} using {planningStyle}.
Create plan-only team {name} in plan {planId} as {planningStyle} with members {memberAccountIds}.
DELETE /rest/api/3/plans/plan/{planId}/team/planonly/{planOnlyTeamId} Delete a plan-only team · Delete plan-only team #
Ask an LLM
“Can I delete a team that only exists in one plan?”
“What gets removed when a plan-only team is deleted?”
Tell an agent destructive · confirm first
Delete plan-only team {planOnlyTeamId} from plan {planId}.
Permanently remove plan-only team {planOnlyTeamId} and its settings in plan {planId}.
GET /rest/api/3/plans/plan/{planId}/team/planonly/{planOnlyTeamId} Get a plan-only team's settings · Get plan-only team #
Ask an LLM
“What are the members and capacity of a plan-only team?”
“Can I look up a plan-only team's planning style?”
Tell an agent
Get plan-only team {planOnlyTeamId} in plan {planId}.
Show members and capacity of plan-only team {planOnlyTeamId} in plan {planId}.
PUT /rest/api/3/plans/plan/{planId}/team/planonly/{planOnlyTeamId} Update a plan-only team · Update plan-only team #
Ask an LLM
“Can I rename a plan-only team or change its members?”
“Which settings of a plan-only team can be updated with JSON Patch?”
Tell an agent
Update plan-only team {planOnlyTeamId} in plan {planId}.
Change the members of plan-only team {planOnlyTeamId} in plan {planId}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-teams-in-plan-api-openapi.yml

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-teams-in-plan-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-teams-in-plan-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: ecosystem@atlassian.com
  description: Jira Cloud platform REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  title: Jira Cloud platform REST Teams in plan API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


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