Jira

Jira Groups API

This resource represents groups of users. Use it to get, create, find, and delete groups as well as add and remove users from groups. (\[WARNING\] The standard Atlassian group names are default names only and can be edited or deleted. For example, an admin or Atlassian support could delete the default group jira-software-users or rename it to jsw-users at any point. See https://support.atlassian.com/user-management/docs/create-and-update-groups/ for details.)

GitHub OpenAPI

Operations 8

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

DELETE /rest/api/3/group Delete a group · Remove group #
Ask an LLM
“How do I delete a group and move its permissions to another group?”
“Can I remove a group by its ID instead of its name?”
Tell an agent destructive · confirm first
Delete group {groupname}.
Remove group {groupId} and swap its restrictions to {swapGroupId}.
GET /rest/api/3/group Get a group and its users (deprecated) · Get group #
Ask an LLM
“Is there an older endpoint that returns a group together with its users?”
“Can I look up a group by name using the deprecated group call?”
Tell an agent
Get group {groupname} using the deprecated group endpoint.
Show the legacy group record for group ID {groupId}.
POST /rest/api/3/group Create a user group · Create group #
Ask an LLM
“How do I create a new group of users in Jira?”
“Who is allowed to create groups?”
Tell an agent
Create a group named {name}.
Add a new user group {name}.
GET /rest/api/3/group/bulk List groups in bulk · Bulk get groups #
Ask an LLM
“Can I get a paginated list of all groups on my site?”
“Which groups grant access to a particular application?”
Tell an agent
List groups with names {groupName}.
Show groups with {accessType} access to application {applicationKey}.
GET /rest/api/3/group/member List members of a group · Get users from group #
Ask an LLM
“Who are the members of a given group?”
“Can I include inactive users when listing a group's members?”
Tell an agent
List the members of group {groupname}.
Show all users in group {groupId}, including inactive ones: {includeInactiveUsers}.
DELETE /rest/api/3/group/user Remove a user from a group · Remove user from group #
Ask an LLM
“How do I take a user out of a group?”
“Can I remove someone from a group using their account ID?”
Tell an agent destructive · confirm first
Remove user {accountId} from group {groupname}.
Take {accountId} out of group ID {groupId}.
POST /rest/api/3/group/user Add a user to a group · Add user to group #
Ask an LLM
“How do I add someone to a group?”
“Do I need site admin rights to add a user to a group?”
Tell an agent
Add user {accountId} to group {groupname}.
Put {accountId} into group ID {groupId}.
GET /rest/api/3/groups/picker Search groups by name for a picker · Find groups #
Ask an LLM
“Which groups have names containing a given word?”
“Can I exclude certain groups from group picker suggestions?”
Tell an agent
Find groups whose names contain {query}.
Suggest groups matching {query}, excluding {exclude}.

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-groups-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-groups-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-groups-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 Groups API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


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