# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Atlassian The Jira Cloud platform REST Project Role Actors…
  version: 1.0.0
extends: openapi/atlassian-project-role-actors-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/rest/api/3/project/{projectIdOrKey}/role/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all actors in a project role
      effect: write
      questions:
      - How do I overwrite everyone in a project's Developers role with a new list?
      - Does setting role actors replace the existing members?
      instructions:
      - text: Replace the actors of role {id} in project {projectIdOrKey} with {categorisedActors}.
        slots:
          id: path.id
          projectIdOrKey: path.projectIdOrKey
          categorisedActors: requestBody.categorisedActors
      - text: Set project {projectIdOrKey}'s role {id} membership to exactly {categorisedActors}.
        slots:
          projectIdOrKey: path.projectIdOrKey
          id: path.id
          categorisedActors: requestBody.categorisedActors
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/project/{projectIdOrKey}/role/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Add users or groups to a project role
      effect: write
      questions:
      - How do I add someone to a project role without removing existing members?
      - Can I add a whole group to a role in one project?
      instructions:
      - text: Add users {user} to role {id} in project {projectIdOrKey}.
        slots:
          user: requestBody.user
          id: path.id
          projectIdOrKey: path.projectIdOrKey
      - text: Add group {groupId} to project {projectIdOrKey}'s role {id}.
        slots:
          groupId: requestBody.groupId
          projectIdOrKey: path.projectIdOrKey
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/project/{projectIdOrKey}/role/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user or group from a project role
      effect: destructive
      questions:
      - How do I take a person out of a role in one project?
      - Can I remove a group from a single project's role?
      instructions:
      - text: Remove user {user} from role {id} in project {projectIdOrKey}.
        slots:
          user: query.user
          id: path.id
          projectIdOrKey: path.projectIdOrKey
      - text: Drop group {groupId} from project {projectIdOrKey}'s role {id}.
        slots:
          groupId: query.groupId
          projectIdOrKey: path.projectIdOrKey
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/role/{id}/actors'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project role's default actors
      effect: read
      questions:
      - Who gets added to a role by default when new projects are created?
      - What are the default members of a project role site-wide?
      instructions:
      - text: List the default actors for project role {id}.
        slots:
          id: path.id
      - text: Show who new projects inherit in role {id} by default.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/role/{id}/actors'].post
  update:
    x-apievangelist-phrasing:
      intent: Add default actors to a project role
      effect: write
      questions:
      - How do I make a group a default member of a role for new projects?
      - Does changing a role's default actors affect projects that already exist?
      instructions:
      - text: Add users {user} as default actors of role {id}.
        slots:
          user: requestBody.user
          id: path.id
      - text: Make group {groupId} a default member of project role {id} for future projects.
        slots:
          groupId: requestBody.groupId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/role/{id}/actors'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove default actors from a project role
      effect: destructive
      questions:
      - How do I stop a user being a default role member in newly created projects?
      - Can I remove a group and a user from default actors in one request?
      instructions:
      - text: Remove user {user} from the default actors of role {id}.
        slots:
          user: query.user
          id: path.id
      - text: Delete group {groupId} from role {id}'s defaults for new projects.
        slots:
          groupId: query.groupId
          id: path.id
      method: generated
      generated: '2026-10-01'