API Evangelist conversational phrasing for Palo Alto Networks Repositories API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Palo Alto Networks Repositories API
  version: 1.0.0
extends: openapi/palo-alto-networks-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: 11
- target: $.paths['/code/api/v1/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List integrated code repositories
      effect: read
      questions:
      - Which repositories are integrated with Application Security, and who owns them?
      - Can I include each repository's error count in the list?
      instructions:
      - text: List my integrated repositories with owner and source.
      - text: 'List integrated repositories including error counts: {errorsCount}.'
        slots:
          errorsCount: query.errorsCount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repositories'].post
  update:
    x-apievangelist-phrasing:
      intent: Onboard multiple repositories for an integration
      effect: write
      questions:
      - How do I onboard a batch of repositories from one VCS integration at once?
      - Can I select which repositories an existing integration should scan?
      instructions:
      - text: Onboard repositories {data} for integration {id}.
        slots:
          data: requestBody.data
          id: requestBody.id
      - text: Integrate the repository list {data} with integration type {type}.
        slots:
          data: requestBody.data
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repositories/branches'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's branches with CI/CD runs
      effect: read
      questions:
      - Which branches of a repository have had CI/CD runs, and what was their status?
      - What branch details are shown for a repo that has pipeline runs?
      instructions:
      - text: List branches with CI/CD runs for {repoOwner}/{repoName}.
        slots:
          repoOwner: query.repoOwner
          repoName: query.repoName
      - text: Show the CI/CD status of each branch in repository {repoName} owned by {repoOwner}.
        slots:
          repoName: query.repoName
          repoOwner: query.repoOwner
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repositories/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Map repository UUIDs to repository names
      effect: read
      questions:
      - How do I turn a list of repository UUIDs into readable repository names?
      - Can I resolve several repository IDs to names in a single request?
      instructions:
      - text: Resolve repository IDs {repositoriesIds} to their names.
        slots:
          repositoriesIds: requestBody.repositoriesIds
      - text: Give me the repository name for each UUID in {repositoriesIds}.
        slots:
          repositoriesIds: requestBody.repositoriesIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repositories/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search repositories by owner, name or source
      effect: read
      questions:
      - How can I find a repository by owner and name among everything I have connected?
      - Can I search only the repositories that are selected for scanning?
      instructions:
      - text: Search repositories named {repoName} from owner {repoOwner}.
        slots:
          repoName: query.repoName
          repoOwner: query.repoOwner
      - text: 'Search repositories from source {source} that are selected: {selected}.'
        slots:
          source: query.source
          selected: query.selected
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/vcs-repository/repositories'].post
  update:
    x-apievangelist-phrasing:
      intent: Page through VCS repositories (code API path)
      effect: read
      questions:
      - Is there a filtered, paged repositories view under the /code API path?
      - Can I sort the /code VCS repositories page by a chosen field?
      instructions:
      - text: Fetch a page of VCS repositories from the /code endpoint with filters {filters}.
        slots:
          filters: requestBody.filters
      - text: Get the /code VCS repositories page ordered by {orderBy} with page config {pageConfig}.
        slots:
          orderBy: requestBody.orderBy
          pageConfig: requestBody.pageConfig
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/vcs-repository/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories with technologies and pipelines
      effect: read
      questions:
      - What technologies, pipelines and contributors does each of my repositories have?
      - Can I list only private repositories that use a given technology?
      - Does the repositories list include Docker images when I ask for them?
      instructions:
      - text: List repositories using technologies {technologies} with pipelines included.
        slots:
          technologies: query.technologies
      - text: Show repositories from providers {providers} at privacy level {privacy_levels}.
        slots:
          providers: query.providers
          privacy_levels: query.privacy_levels
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/vcs-repository/repositories'].post
  update:
    x-apievangelist-phrasing:
      intent: Page through VCS repositories with filters
      effect: read
      questions:
      - How do I get a filtered page of VCS repositories through the /api/v1 repositories POST?
      - Which filters and ordering can I send in the body to page VCS repositories?
      instructions:
      - text: Post filters {filters} to the /api/v1 VCS repositories page and return the results.
        slots:
          filters: requestBody.filters
      - text: Get the /api/v1 VCS repositories page sorted by {orderBy} using {pageConfig}.
        slots:
          orderBy: requestBody.orderBy
          pageConfig: requestBody.pageConfig
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories connected to Code Security
      effect: read
      questions:
      - Which repositories are connected to Prisma Cloud Code Security and when were they last scanned?
      - Can I list only connected repositories from one VCS source type?
      instructions:
      - text: List connected Code Security repositories from source type {sourceType}.
        slots:
          sourceType: query.sourceType
      - text: Find connected repositories matching {search}.
        slots:
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repositories'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a repository to Code Security
      effect: write
      questions:
      - How do I connect a new VCS repository so it gets scanned automatically?
      - Does adding a repository trigger a scan of its default branch?
      instructions:
      - text: Connect repository {owner}/{name} with ID {id} from {sourceType}.
        slots:
          owner: requestBody.owner
          name: requestBody.name
          id: requestBody.id
          sourceType: requestBody.sourceType
      - text: Add {sourceType} repository {name} owned by {owner} (ID {id}) with default branch {defaultBranch}.
        slots:
          sourceType: requestBody.sourceType
          name: requestBody.name
          owner: requestBody.owner
          id: requestBody.id
          defaultBranch: requestBody.defaultBranch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repositories'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect a repository from Code Security
      effect: destructive
      questions:
      - How do I disconnect a repository from Code Security scanning?
      - Is scan history kept after a repository is removed?
      instructions:
      - text: Disconnect repository {id} from Code Security.
        slots:
          id: requestBody.id
      - text: Remove {sourceType} repository {id} from scanning.
        slots:
          sourceType: requestBody.sourceType
          id: requestBody.id
      method: generated
      generated: '2026-09-26'