# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Sentry System Teams API
  version: 1.0.0
extends: openapi/sentry-system-teams-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/organizations/{organization_id_or_slug}/teams/'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's teams
      effect: read
      questions:
      - Which teams exist in my organization?
      - Can I page through all teams in the org?
      instructions:
      - text: List teams in organization {org}.
        slots:
          org: path.organization_id_or_slug
      - text: Show more teams in {org} from cursor {cursor}.
        slots:
          org: path.organization_id_or_slug
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/teams/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a team
      effect: write
      questions:
      - How do I create a new team?
      - Can I choose a team's slug when creating it?
      instructions:
      - text: Create team {name} in {org}.
        slots:
          name: requestBody.name
          org: path.organization_id_or_slug
      - text: Create a team named {name} with slug {slug}.
        slots:
          name: requestBody.name
          slug: requestBody.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{organization_id_or_slug}/{team_id_or_slug}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a team's details
      effect: read
      questions:
      - What are the details of a particular team?
      - Can I look up a team by its slug?
      instructions:
      - text: Show team {team} in {org}.
        slots:
          team: path.team_id_or_slug
          org: path.organization_id_or_slug
      - text: Fetch details for team {team}.
        slots:
          team: path.team_id_or_slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{organization_id_or_slug}/{team_id_or_slug}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a team
      effect: write
      questions:
      - How do I rename a team?
      - Can I change a team's slug?
      instructions:
      - text: Rename team {team} in {org} to {name}.
        slots:
          team: path.team_id_or_slug
          org: path.organization_id_or_slug
          name: requestBody.name
      - text: Change team {team}'s slug to {slug}.
        slots:
          team: path.team_id_or_slug
          slug: requestBody.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{organization_id_or_slug}/{team_id_or_slug}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a team
      effect: destructive
      questions:
      - What happens to a team's projects when I delete the team?
      - How do I schedule a team for deletion?
      instructions:
      - text: Delete team {team} from {org}.
        slots:
          team: path.team_id_or_slug
          org: path.organization_id_or_slug
      - text: Schedule team {team} for deletion.
        slots:
          team: path.team_id_or_slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{organization_id_or_slug}/{team_id_or_slug}/projects/'].get
  update:
    x-apievangelist-phrasing:
      intent: List a team's projects
      effect: read
      questions:
      - Which projects does a team own?
      - Can I page through all projects bound to a team?
      instructions:
      - text: List projects for team {team} in {org}.
        slots:
          team: path.team_id_or_slug
          org: path.organization_id_or_slug
      - text: Show more of team {team}'s projects from cursor {cursor}.
        slots:
          team: path.team_id_or_slug
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{organization_id_or_slug}/{project_id_or_slug}/teams/'].get
  update:
    x-apievangelist-phrasing:
      intent: List teams with access to a project
      effect: read
      questions:
      - Which teams have access to a given project?
      - Who owns this project, team-wise?
      instructions:
      - text: List teams on project {project} in {org}.
        slots:
          project: path.project_id_or_slug
          org: path.organization_id_or_slug
      - text: Show teams with access to project {project}.
        slots:
          project: path.project_id_or_slug
      method: generated
      generated: '2026-09-26'