# 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 Repositories API
  version: 1.0.0
extends: openapi/sentry-system-repositories-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}/repos/'].get
  update:
    x-apievangelist-phrasing:
      intent: List connected code repositories
      effect: read
      questions:
      - Which code repositories are connected to my org for commit tracking?
      - Can I see the version control repos Sentry knows about?
      instructions:
      - text: List version control repositories in {org}.
        slots:
          org: path.organization_id_or_slug
      - text: Show the next page of connected repos 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}/repos/{repo_id}/commits/'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's commits
      effect: read
      questions:
      - What commits has Sentry recorded for one repository?
      - Can I page through a connected repo's commit history?
      instructions:
      - text: List commits for repository {repo_id} in {org}.
        slots:
          repo_id: path.repo_id
          org: path.organization_id_or_slug
      - text: Show recorded commits in repo {repo_id}.
        slots:
          repo_id: path.repo_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/prevent/repositories/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Prevent repositories for an owner
      effect: read
      questions:
      - Which repositories does Prevent track for my organization?
      - Can I page through repositories set up for test analytics?
      instructions:
      - text: List Prevent repositories for {org}.
        slots:
          org: path.organization_id_or_slug
      - text: Show more Prevent repositories 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}/prevent/repositories/{repo_id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Prevent repository
      effect: read
      questions:
      - What does Prevent know about one of my repositories?
      - Can I view a single Prevent repository by ID?
      instructions:
      - text: Show Prevent repository {repo_id} in {org}.
        slots:
          repo_id: path.repo_id
          org: path.organization_id_or_slug
      - text: Fetch details for Prevent repo {repo_id}.
        slots:
          repo_id: path.repo_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/prevent/repositories/{repo_id}/branches/'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's branches
      effect: read
      questions:
      - Which branches exist on a Prevent repository?
      - Can I page through branches for one repo?
      instructions:
      - text: List branches of Prevent repository {repo_id} in {org}.
        slots:
          repo_id: path.repo_id
          org: path.organization_id_or_slug
      - text: Show branches for repo {repo_id} from cursor {cursor}.
        slots:
          repo_id: path.repo_id
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/prevent/sync/'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync repositories from the integrated org
      effect: write
      questions:
      - How do I pull newly created repositories into Prevent?
      - Can I trigger a repository refresh from our connected code host?
      instructions:
      - text: Sync repositories for {org} from the integrated source organization.
        slots:
          org: path.organization_id_or_slug
      - text: Start a repository sync for organization {org}.
        slots:
          org: path.organization_id_or_slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/prevent/sync-status/'].get
  update:
    x-apievangelist-phrasing:
      intent: Check repository sync status
      effect: read
      questions:
      - Is the repository sync still running?
      - Has my last repository sync finished?
      instructions:
      - text: Check repository sync status for {org}.
        slots:
          org: path.organization_id_or_slug
      - text: Show whether {org}'s repositories are still syncing.
        slots:
          org: path.organization_id_or_slug
      method: generated
      generated: '2026-09-26'