Jira

Jira Project role actors API

This resource represents the users assigned to [project roles](#api-group-Issue-comments). Use it to get, add, and remove default users from project roles. Also use it to add and remove users from a project role associated with a project.

GitHub OpenAPI

Operations 6

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/project/{projectIdOrKey}/role/{id} Remove a user or group from a project role · Delete actors from project role #
Ask an LLM
“How do I take a person out of a role in one specific project?”
“Can I remove a group from a project role by its group ID?”
Tell an agent destructive · confirm first
Remove user {user} from role {id} in project {projectIdOrKey}.
Drop group {groupId} from project {projectIdOrKey}'s role {id}.
POST /rest/api/3/project/{projectIdOrKey}/role/{id} Add users or groups to a project role · Add actors to project role #
Ask an LLM
“How do I add someone to a project role without removing current members?”
“Can I add a whole group to a project's role?”
Tell an agent
Add user {user} to role {id} in project {projectIdOrKey}.
Add group {groupId} to project {projectIdOrKey}'s role {id}.
PUT /rest/api/3/project/{projectIdOrKey}/role/{id} Replace all actors in a project role · Set actors for project role #
Ask an LLM
“How do I overwrite everyone in a project role with a new set of users and groups?”
“Does setting project role actors replace the existing members?”
Tell an agent
Replace the actors of role {id} in project {projectIdOrKey} with {categorisedActors}.
Reset role {id} on project {projectIdOrKey} so only these users and groups remain.
DELETE /rest/api/3/role/{id}/actors Remove default actors from a project role · Delete default actors from project role #
Ask an LLM
“How do I stop a user being added to a role by default in new projects?”
“Can I remove a group and a user from a role's defaults in the same call?”
Tell an agent destructive · confirm first
Remove user {user} from the default actors of role {id}.
Remove group {groupId} as a default member of project role {id}.
GET /rest/api/3/role/{id}/actors List a project role's default actors · Get default actors for project role #
Ask an LLM
“Who are the default members of a project role for new projects?”
“Which users and groups get a role automatically when a project is created?”
Tell an agent
List the default actors for project role {id}.
Show who new projects get by default in role {id}.
POST /rest/api/3/role/{id}/actors Add default actors to a project role · Add default actors to project role #
Ask an LLM
“How do I make a group a default member of a role for all future projects?”
“Does changing a role's default actors affect projects that already exist?”
Tell an agent
Add users {user} as default actors of project role {id}.
Make group {groupId} a default member of role {id} for new projects.

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-project-role-actors-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-project-role-actors-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-project-role-actors-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 Project role actors 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-project-role-actors-api-openapi.yml