# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gitea Repository API
  version: 1.0.0
extends: openapi/gitea-repository-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: 197
- target: $.paths['/repos/migrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a remote git repository
      effect: write
      questions:
      - How do I import an existing repository from another git server into Gitea?
      - Can a migration also bring over issues, labels, milestones, releases and the wiki?
      - Is it possible to migrate a remote repo as a mirror that keeps syncing on an interval?
      instructions:
      - text: Migrate the repository at {clone_addr} into a new repo called {repo_name}.
        slots:
          clone_addr: requestBody.clone_addr
          repo_name: requestBody.repo_name
      - text: Import {clone_addr} as {repo_name} under {repo_owner}, including its issues and pull requests.
        slots:
          clone_addr: requestBody.clone_addr
          repo_name: requestBody.repo_name
          repo_owner: requestBody.repo_owner
      - text: Set up {clone_addr} as a pull mirror named {repo_name} that syncs every {mirror_interval}.
        slots:
          clone_addr: requestBody.clone_addr
          repo_name: requestBody.repo_name
          mirror_interval: requestBody.mirror_interval
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search repositories
      effect: read
      questions:
      - What's the way to find repositories matching a keyword across the whole instance?
      - Can I search repos by topic and include their descriptions in the match?
      - Which repositories has a given user starred, or are archived or templates?
      instructions:
      - text: Search all repositories for {q}.
        slots:
          q: query.q
      - text: Find repositories tagged with topic {q}, sorted by {sort}.
        slots:
          q: query.q
          sort: query.sort
      - text: Search for template repositories matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's details
      effect: read
      questions:
      - How can I look up the details of a single repository, like its default branch and visibility?
      - What settings and metadata does a repository expose when I fetch it by owner and name?
      instructions:
      - text: Show me the details of repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Get the default branch and visibility of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository
      effect: destructive
      questions:
      - How do I permanently delete a repository?
      - Can a deleted repository be recovered afterwards?
      instructions:
      - text: Delete the repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Permanently remove {owner}/{repo} and all of its content.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a repository's settings
      effect: write
      questions:
      - Can I rename a repository or change its description and website?
      - How do I archive a repo or make it private after it was created?
      - Which merge styles can I allow or disallow on a repository, like squash or rebase?
      - Is it possible to turn off the wiki, issues or pull requests for one repo?
      instructions:
      - text: Rename repository {owner}/{repo} to {name}.
        slots:
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      - text: Archive the repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Change the default branch of {owner}/{repo} to {default_branch}.
        slots:
          owner: path.owner
          repo: path.repo
          default_branch: requestBody.default_branch
      - text: Set the description of {owner}/{repo} to {description}.
        slots:
          owner: path.owner
          repo: path.repo
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions artifacts
      effect: read
      questions:
      - What build artifacts have Actions workflows produced in this repository?
      - Can I filter a repository's workflow artifacts by name?
      instructions:
      - text: List all Actions artifacts in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Find artifacts named {name} across every run in {owner}/{repo}.
        slots:
          name: query.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Actions artifact
      effect: read
      questions:
      - How do I see the metadata of a single workflow artifact, like its size and expiry?
      - Which run produced a given artifact?
      instructions:
      - text: Show artifact {artifact_id} in {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Get the size and expiry details of artifact {artifact_id} from {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Actions artifact
      effect: destructive
      questions:
      - How can I delete a workflow artifact I no longer need to free up storage?
      - Can I remove a single build artifact without deleting the whole run?
      instructions:
      - text: Delete artifact {artifact_id} from {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Remove the workflow artifact {artifact_id} in {owner}/{repo} to free space.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip'].get
  update:
    x-apievangelist-phrasing:
      intent: Download an Actions artifact as a zip
      effect: read
      questions:
      - How do I download the zip file of a workflow artifact?
      - Where does the artifact download redirect me to get the actual file?
      instructions:
      - text: Download artifact {artifact_id} from {owner}/{repo} as a zip.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Fetch the zip archive for artifact {artifact_id} in {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's workflow jobs
      effect: read
      questions:
      - Which Actions jobs have run across the whole repository recently?
      - Can I list only the jobs in a certain status, such as queued or failed, for a repo?
      instructions:
      - text: List all workflow jobs in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show jobs in {owner}/{repo} with status {status}.
        slots:
          owner: path.owner
          repo: path.repo
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs/{job_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one workflow job
      effect: read
      questions:
      - How do I check the status and steps of a single Actions job?
      - What runner did a particular workflow job run on?
      instructions:
      - text: Show workflow job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      - text: Get the status and steps of job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs/{job_id}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a workflow job's logs
      effect: read
      questions:
      - How can I get the log output of an Actions job to see why it failed?
      - Can I download the full logs of one job in a workflow run?
      instructions:
      - text: Download the logs for job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      - text: Fetch the log output of workflow job {job_id} from {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions runners
      effect: read
      questions:
      - Which self-hosted runners are registered to this repository?
      - Can I list only the disabled runners attached to a repo?
      instructions:
      - text: List the Actions runners registered to {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show disabled runners for {owner}/{repo}, filtering on {disabled}.
        slots:
          owner: path.owner
          repo: path.repo
          disabled: query.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/registration-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a runner registration token for a repo
      effect: write
      questions:
      - How do I get a token to register a new self-hosted runner for a repository?
      - Where does the registration token for connecting a runner to one repo come from?
      instructions:
      - text: Generate a runner registration token for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Create a new Actions runner registration token in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository runner
      effect: read
      questions:
      - How can I check the status and labels of one runner attached to a repo?
      - Is a specific repository runner online or disabled?
      instructions:
      - text: Show runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Check whether runner {runner_id} for {owner}/{repo} is online.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a repository runner
      effect: destructive
      questions:
      - How do I unregister a self-hosted runner from a repository?
      - Can I remove a runner that's no longer used by one repo?
      instructions:
      - text: Delete runner {runner_id} from {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Unregister the Actions runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable a repository runner
      effect: write
      questions:
      - Can I temporarily disable a repository's runner so it stops picking up jobs?
      - How do I re-enable a runner I previously disabled on a repo?
      instructions:
      - text: Disable runner {runner_id} in {owner}/{repo} by setting disabled to {disabled}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          disabled: requestBody.disabled
      - text: Re-enable Actions runner {runner_id} for {owner}/{repo} with disabled {disabled}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          disabled: requestBody.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's workflow runs
      effect: read
      questions:
      - Which Actions runs have happened in a repo, and can I filter them by branch or event?
      - How can I find the workflow runs triggered by a specific commit SHA or actor?
      instructions:
      - text: List workflow runs in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show runs in {owner}/{repo} on branch {branch} with status {status}.
        slots:
          owner: path.owner
          repo: path.repo
          branch: query.branch
          status: query.status
      - text: Find workflow runs in {owner}/{repo} for commit {head_sha}.
        slots:
          owner: path.owner
          repo: path.repo
          head_sha: query.head_sha
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow run
      effect: read
      questions:
      - How do I check the outcome and timing of one workflow run?
      - What triggered a particular Actions run and did it succeed?
      instructions:
      - text: Show workflow run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Get the conclusion of run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workflow run
      effect: destructive
      questions:
      - Can I delete an old workflow run from a repository's Actions history?
      - How do I clean up a run I no longer want to keep?
      instructions:
      - text: Delete workflow run {run} from {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Remove Actions run {run} and its history in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifacts from one workflow run
      effect: read
      questions:
      - Which artifacts did a single workflow run upload?
      - Can I filter the artifacts of one run by artifact name?
      instructions:
      - text: List the artifacts produced by run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Find the artifact named {name} from run {run} in {owner}/{repo}.
        slots:
          name: query.name
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List jobs in a workflow run
      effect: read
      questions:
      - What jobs make up a particular workflow run and how did each one do?
      - Can I see only the failed jobs inside one run?
      instructions:
      - text: List the jobs in workflow run {run} of {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Show jobs with status {status} in run {run} of {owner}/{repo}.
        slots:
          status: query.status
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/jobs/{job_id}/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun a single job in a workflow run
      effect: write
      questions:
      - Can I rerun just one job in a run instead of the whole workflow?
      - How do I retry a single flaky job?
      instructions:
      - text: Rerun job {job_id} in run {run} of {owner}/{repo}.
        slots:
          job_id: path.job_id
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Retry only job {job_id} from workflow run {run} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun an entire workflow run
      effect: write
      questions:
      - How do I rerun every job in a workflow run from scratch?
      - Is there a way to restart a whole Actions run?
      instructions:
      - text: Rerun the entire workflow run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Restart all jobs of run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/rerun-failed-jobs'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun the failed jobs of a workflow run
      effect: write
      questions:
      - Can I rerun only the jobs that failed in a run and keep the ones that passed?
      - What's the quickest way to retry the failures from one workflow run?
      instructions:
      - text: Rerun the failed jobs of run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Retry every failed job from workflow run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions secrets
      effect: read
      questions:
      - Which Actions secrets are defined on a repository?
      - Can I see the names of repo secrets without their values?
      instructions:
      - text: List the Actions secrets for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the secret names configured in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/{secretname}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a repository secret
      effect: write
      questions:
      - How do I add an Actions secret, like a deploy token, to a repository?
      - Can I overwrite the value of an existing repo secret?
      instructions:
      - text: Set secret {secretname} in {owner}/{repo} to {data}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
          data: requestBody.data
      - text: Create the Actions secret {secretname} for {owner}/{repo} with value {data} and description {description}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
          data: requestBody.data
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/{secretname}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository secret
      effect: destructive
      questions:
      - How can I remove an Actions secret from a repository?
      - Will deleting a repo secret break workflows that reference it?
      instructions:
      - text: Delete the secret {secretname} from {owner}/{repo}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
      - text: Remove Actions secret {secretname} in {owner}/{repo}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/tasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions tasks
      effect: read
      questions:
      - What Actions tasks have been executed for a repository?
      - Can I page through the task history of a repo's Actions?
      instructions:
      - text: List the Actions tasks for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the next {limit} Actions tasks for {owner}/{repo}.
        slots:
          limit: query.limit
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions variables
      effect: read
      questions:
      - Which Actions configuration variables does a repository define?
      - Can I list all repo-level variables available to workflows?
      instructions:
      - text: List the Actions variables in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show all repo-level workflow variables for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository Actions variable
      effect: read
      questions:
      - How do I read the current value of one repo-level variable?
      - What is a specific Actions variable set to on a repository?
      instructions:
      - text: Get the variable {variablename} in {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      - text: Show the value of Actions variable {variablename} for {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a repository Actions variable
      effect: write
      questions:
      - Can I change the value of a repo variable that already exists?
      - How do I rename an existing Actions variable on a repository?
      instructions:
      - text: Change existing variable {variablename} in {owner}/{repo} to {value}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
          value: requestBody.value
      - text: Rename Actions variable {variablename} in {owner}/{repo} to {name} with value {value}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
          name: requestBody.name
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a repository Actions variable
      effect: write
      questions:
      - How do I add a new configuration variable for a repo's workflows?
      - Can I give a new repo-level variable a description when creating it?
      instructions:
      - text: Create a new variable {variablename} in {owner}/{repo} with value {value}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
          value: requestBody.value
      - text: Add Actions variable {variablename} = {value} to {owner}/{repo} described as {description}.
        slots:
          variablename: path.variablename
          value: requestBody.value
          owner: path.owner
          repo: path.repo
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository Actions variable
      effect: destructive
      questions:
      - How can I remove a repo-level Actions variable?
      - Is it possible to delete a workflow variable I no longer use?
      instructions:
      - text: Delete the variable {variablename} from {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      - text: Remove Actions variable {variablename} in {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's workflows
      effect: read
      questions:
      - Which workflow files are defined in a repository?
      - Can I see all Actions workflows a repo has and whether they're enabled?
      instructions:
      - text: List the workflows in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every Actions workflow file defined in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow
      effect: read
      questions:
      - How do I look up one workflow's details, like its path and state?
      - Is a particular workflow currently active?
      instructions:
      - text: Show workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Get the state and path of workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable'].put
  update:
    x-apievangelist-phrasing:
      intent: Disable a workflow
      effect: write
      questions:
      - How do I stop a workflow from running without deleting its file?
      - Can I pause a scheduled workflow in a repository?
      instructions:
      - text: Disable workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Turn off the workflow {workflow_id} for {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches'].post
  update:
    x-apievangelist-phrasing:
      intent: Manually trigger a workflow
      effect: write
      questions:
      - How do I kick off a workflow manually on a chosen branch or tag?
      - Can I pass inputs when triggering a workflow dispatch event?
      - Does triggering a workflow return the details of the run it created?
      instructions:
      - text: Trigger workflow {workflow_id} in {owner}/{repo} on {ref}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
          ref: requestBody.ref
      - text: Dispatch workflow {workflow_id} in {owner}/{repo} on {ref} with inputs {inputs}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
          ref: requestBody.ref
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable a workflow
      effect: write
      questions:
      - How can I turn a disabled workflow back on?
      - Can I resume a workflow that was paused?
      instructions:
      - text: Enable workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Re-activate the disabled workflow {workflow_id} for {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/activities/feeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's activity feed
      effect: read
      questions:
      - What has been happening in a repository lately, like pushes and merged PRs?
      - Can I see a repo's activity for one specific date?
      instructions:
      - text: Show the activity feed for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: List activity in {owner}/{repo} on {date}.
        slots:
          owner: path.owner
          repo: path.repo
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/archive/{archive}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a repository archive
      effect: read
      questions:
      - How do I download a repo snapshot as a zip or tarball at a given branch or tag?
      - Can I archive just one subdirectory of a repository?
      instructions:
      - text: Download the archive {archive} of {owner}/{repo}.
        slots:
          archive: path.archive
          owner: path.owner
          repo: path.repo
      - text: Get archive {archive} of {owner}/{repo} limited to path {path}.
        slots:
          archive: path.archive
          owner: path.owner
          repo: path.repo
          path: query.path
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/assignees'].get
  update:
    x-apievangelist-phrasing:
      intent: List users who can be assigned to issues
      effect: read
      questions:
      - Who can I assign issues to in a repository?
      - Which users have write access and are valid issue assignees?
      instructions:
      - text: List the possible issue assignees for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show everyone in {owner}/{repo} who can be assigned issues.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/avatar'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a repository's avatar
      effect: write
      questions:
      - Can I set a custom avatar image for a repository?
      - How do I change a repo's picture?
      instructions:
      - text: Set the avatar of {owner}/{repo} to image {image}.
        slots:
          owner: path.owner
          repo: path.repo
          image: requestBody.image
      - text: Upload {image} as the new avatar for {owner}/{repo}.
        slots:
          image: requestBody.image
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/avatar'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a repository's avatar
      effect: destructive
      questions:
      - How do I remove a repository's custom avatar?
      - Can I reset a repo back to the default picture?
      instructions:
      - text: Delete the avatar of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Remove the custom repository image from {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branch_protections'].get
  update:
    x-apievangelist-phrasing:
      intent: List branch protection rules
      effect: read
      questions:
      - Which branch protection rules are set up on a repository?
      - What branches are protected in this repo?
      instructions:
      - text: List the branch protections for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every branch protection rule in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branch_protections'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a branch protection rule
      effect: write
      questions:
      - How do I protect the main branch so nobody can force-push to it?
      - Can a protection rule require a number of approvals and passing status checks before merging?
      - Is it possible to require signed commits on a protected branch?
      instructions:
      - text: Protect branch {branch_name} in {owner}/{repo}.
        slots:
          branch_name: requestBody.branch_name
          owner: path.owner
          repo: path.repo
      - text: Create protection rule {rule_name} in {owner}/{repo} requiring {required_approvals} approvals.
        slots:
          rule_name: requestBody.rule_name
          owner: path.owner
          repo: path.repo
          required_approvals: requestBody.required_approvals
      - text: Protect {branch_name} in {owner}/{repo} and require status checks {status_check_contexts}.
        slots:
          branch_name: requestBody.branch_name
          owner: path.owner
          repo: path.repo
          status_check_contexts: requestBody.status_check_contexts
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branch_protections/priority'].post
  update:
    x-apievangelist-phrasing:
      intent: Reorder branch protection priorities
      effect: write
      questions:
      - When several protection rules match a branch, how do I set which one wins?
      - Can I change the order of a repo's branch protection rules?
      instructions:
      - text: Reorder the branch protection rules of {owner}/{repo} to {ids}.
        slots:
          owner: path.owner
          repo: path.repo
          ids: requestBody.ids
      - text: Set branch protection priority in {owner}/{repo} to the order {ids}.
        slots:
          owner: path.owner
          repo: path.repo
          ids: requestBody.ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branch_protections/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a branch protection rule
      effect: read
      questions:
      - What exactly does a specific branch protection rule enforce?
      - How many approvals does a given protection rule require?
      instructions:
      - text: Show the branch protection rule {name} in {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      - text: Get the settings of protection rule {name} for {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branch_protections/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a branch protection rule
      effect: destructive
      questions:
      - How do I remove protection from a branch?
      - Can I delete a single branch protection rule?
      instructions:
      - text: Delete the branch protection rule {name} in {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      - text: Remove protection rule {name} from {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branch_protections/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a branch protection rule
      effect: write
      questions:
      - Can I change the required approvals on an existing protection rule?
      - How do I add users to the push allowlist of a protected branch that's already set up?
      instructions:
      - text: Change protection rule {name} in {owner}/{repo} to require {required_approvals} approvals.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
          required_approvals: requestBody.required_approvals
      - text: Allow {push_whitelist_usernames} to push to protected rule {name} in {owner}/{repo}.
        slots:
          push_whitelist_usernames: requestBody.push_whitelist_usernames
          name: path.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branches'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's branches
      effect: read
      questions:
      - What branches exist in a repository?
      - Can I page through all branches of a large repo?
      instructions:
      - text: List the branches in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show {limit} branches per page for {owner}/{repo}.
        slots:
          limit: query.limit
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branches'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a branch
      effect: write
      questions:
      - How do I create a new branch from an existing one?
      - Can I start a branch from a specific tag or commit instead of a branch?
      instructions:
      - text: Create branch {new_branch_name} in {owner}/{repo}.
        slots:
          new_branch_name: requestBody.new_branch_name
          owner: path.owner
          repo: path.repo
      - text: Create branch {new_branch_name} in {owner}/{repo} from {old_branch_name}.
        slots:
          new_branch_name: requestBody.new_branch_name
          owner: path.owner
          repo: path.repo
          old_branch_name: requestBody.old_branch_name
      - text: Branch {new_branch_name} off ref {old_ref_name} in {owner}/{repo}.
        slots:
          new_branch_name: requestBody.new_branch_name
          old_ref_name: requestBody.old_ref_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branches/{branch}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a branch
      effect: read
      questions:
      - Which commit is a branch currently pointing at?
      - Is a particular branch protected, and by what rule?
      instructions:
      - text: Show branch {branch} in {owner}/{repo}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
      - text: Get the latest commit and effective protection of {branch} in {owner}/{repo}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branches/{branch}'].put
  update:
    x-apievangelist-phrasing:
      intent: Point a branch at a different commit
      effect: write
      questions:
      - Can I move a branch to point at a different commit?
      - Is a force update allowed when resetting a branch to a commit that isn't a descendant?
      instructions:
      - text: Move branch {branch} in {owner}/{repo} to commit {new_commit_id}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
          new_commit_id: requestBody.new_commit_id
      - text: Force-reset {branch} in {owner}/{repo} to {new_commit_id}, setting force to {force}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
          new_commit_id: requestBody.new_commit_id
          force: requestBody.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branches/{branch}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a branch
      effect: destructive
      questions:
      - How do I delete a branch after its work is merged?
      - Can I remove a stale branch from a repository?
      instructions:
      - text: Delete branch {branch} from {owner}/{repo}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
      - text: Remove the stale branch {branch} in {owner}/{repo}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/branches/{branch}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a branch
      effect: write
      questions:
      - Can I rename a branch, say from master to main?
      - What happens to a branch's name when I rename it through the API?
      instructions:
      - text: Rename branch {branch} in {owner}/{repo} to {name}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      - text: Change the name of {branch} in {owner}/{repo} to {name}.
        slots:
          branch: path.branch
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/collaborators'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's collaborators
      effect: read
      questions:
      - Who has been added as a collaborator on a repository?
      - Can I page through a repo's collaborator list?
      instructions:
      - text: List the collaborators on {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show everyone added as a collaborator to {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/collaborators/{collaborator}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a user is a collaborator
      effect: read
      questions:
      - Is a particular user a collaborator on this repository?
      - Can I verify someone's collaborator status on a repo?
      instructions:
      - text: Check whether {collaborator} is a collaborator on {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          owner: path.owner
          repo: path.repo
      - text: Confirm {collaborator} has collaborator access to {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/collaborators/{collaborator}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update a collaborator
      effect: write
      questions:
      - How do I give another user access to my repository?
      - Can I change a collaborator's permission level to read, write or admin?
      instructions:
      - text: Add {collaborator} as a collaborator on {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          owner: path.owner
          repo: path.repo
      - text: Give {collaborator} {permission} permission on {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          permission: requestBody.permission
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/collaborators/{collaborator}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a collaborator
      effect: destructive
      questions:
      - How do I revoke someone's collaborator access to a repo?
      - Can I remove a user from a repository's collaborators?
      instructions:
      - text: Remove {collaborator} as a collaborator from {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          owner: path.owner
          repo: path.repo
      - text: Revoke collaborator access for {collaborator} on {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/collaborators/{collaborator}/permission'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's permission on a repository
      effect: read
      questions:
      - What permission level does a given user have on a repository?
      - Does this user have admin, write or only read rights on the repo?
      instructions:
      - text: Get the repository permission of {collaborator} on {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          owner: path.owner
          repo: path.repo
      - text: Tell me what access level {collaborator} has in {owner}/{repo}.
        slots:
          collaborator: path.collaborator
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/commits'].get
  update:
    x-apievangelist-phrasing:
      intent: List commits in a repository
      effect: read
      questions:
      - How can I see the commit history of a repository or a single file?
      - Can I list commits between two dates or starting from a specific branch?
      - Is there a way to exclude commits reachable from another ref?
      instructions:
      - text: List the commits in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show commits on {sha} in {owner}/{repo} that touched {path}.
        slots:
          sha: query.sha
          owner: path.owner
          repo: path.repo
          path: query.path
      - text: List commits in {owner}/{repo} made since {since} and before {until}.
        slots:
          owner: path.owner
          repo: path.repo
          since: query.since
          until: query.until
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/commits/{ref}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a ref's combined commit status
      effect: read
      questions:
      - Did all CI checks pass on a branch or tag overall?
      - What's the single combined status of the latest commit on a ref?
      instructions:
      - text: Get the combined status of {ref} in {owner}/{repo}.
        slots:
          ref: path.ref
          owner: path.owner
          repo: path.repo
      - text: Tell me whether all checks passed overall for {ref} in {owner}/{repo}.
        slots:
          ref: path.ref
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/commits/{ref}/statuses'].get
  update:
    x-apievangelist-phrasing:
      intent: List commit statuses for a branch or tag
      effect: read
      questions:
      - Which individual CI statuses were reported on the tip of a branch or tag?
      - Can I filter the statuses on a ref by state, like only failures?
      instructions:
      - text: List every status reported on branch or tag {ref} in {owner}/{repo}.
        slots:
          ref: path.ref
          owner: path.owner
          repo: path.repo
      - text: Show {state} statuses for ref {ref} in {owner}/{repo}.
        slots:
          state: query.state
          ref: path.ref
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/commits/{sha}/pull'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the pull request that merged a commit
      effect: read
      questions:
      - Which pull request brought a given commit into the repository?
      - Can I trace a commit SHA back to its merged PR?
      instructions:
      - text: Find the merged pull request for commit {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Show which PR merged {sha} into {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/compare/{basehead}'].get
  update:
    x-apievangelist-phrasing:
      intent: Compare two branches or commits
      effect: read
      questions:
      - How do I compare two branches to see which commits differ?
      - What changed between two tags or commits in a repo?
      instructions:
      - text: Compare {basehead} in {owner}/{repo}.
        slots:
          basehead: path.basehead
          owner: path.owner
          repo: path.repo
      - text: Show the commit differences for {basehead} in {owner}/{repo}.
        slots:
          basehead: path.basehead
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/contents'].get
  update:
    x-apievangelist-phrasing:
      intent: List the root directory's entries
      effect: read
      questions:
      - What files and folders are at the top level of a repository?
      - Can I list the root directory entries at a particular branch or tag?
      instructions:
      - text: List the root directory entries of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the top-level files of {owner}/{repo} at ref {ref}.
        slots:
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/contents'].post
  update:
    x-apievangelist-phrasing:
      intent: Change multiple files in one commit
      effect: write
      questions:
      - Can I create, update and delete several files in a single commit?
      - How do I commit a batch of file changes to a new branch?
      instructions:
      - text: Commit the file changes {files} to {owner}/{repo} with message {message}.
        slots:
          files: requestBody.files
          owner: path.owner
          repo: path.repo
          message: requestBody.message
      - text: Apply {files} to {owner}/{repo} on new branch {new_branch} in one commit.
        slots:
          files: requestBody.files
          owner: path.owner
          repo: path.repo
          new_branch: requestBody.new_branch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/contents-ext/{filepath}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get file metadata or list a directory (extended)
      effect: read
      questions:
      - What's the recommended way to fetch a file's metadata or list a directory in one call?
      - Can the extended contents call include file content or LFS metadata on request?
      instructions:
      - text: Get extended contents for {filepath} in {owner}/{repo}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
      - text: Fetch {filepath} in {owner}/{repo} at {ref} including {includes}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          ref: query.ref
          includes: query.includes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/contents/{filepath}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a file or directory's contents
      effect: read
      questions:
      - How do I read a file's content and metadata, or list a subfolder, in a repo?
      - Can I get the contents of a path as of an older branch or commit?
      instructions:
      - text: Get the contents of {filepath} in {owner}/{repo}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
      - text: Show {filepath} from {owner}/{repo} as it was at ref {ref}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/contents/{filepath}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update or create a single file
      effect: write
      questions:
      - How do I edit an existing file in a repository and commit the change?
      - Can I move a file to a new path while updating it?
      instructions:
      - text: Update {filepath} in {owner}/{repo} with {content} using blob sha {sha}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          content: requestBody.content
          sha: requestBody.sha
      - text: Overwrite {filepath} in {owner}/{repo} with {content} and message {message}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          content: requestBody.content
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/contents/{filepath}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new file
      effect: write
      questions:
      - How do I add a new file to a repository through the API?
      - Can I create a file on a new branch rather than the default one?
      instructions:
      - text: Create file {filepath} in {owner}/{repo} with content {content}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          content: requestBody.content
      - text: Add new file {filepath} to {owner}/{repo} on branch {branch} with {content}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          branch: requestBody.branch
          content: requestBody.content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/contents/{filepath}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file
      effect: destructive
      questions:
      - How do I delete a single file from a repository in a commit?
      - What do I need to supply to delete a file, such as its current SHA?
      instructions:
      - text: Delete {filepath} from {owner}/{repo} with blob sha {sha}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          sha: requestBody.sha
      - text: Remove file {filepath} in {owner}/{repo}, sha {sha}, message {message}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          sha: requestBody.sha
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/diffpatch'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply a diff patch
      effect: write
      questions:
      - Can I apply a unified diff or patch directly to a repository?
      - How do I commit changes from a patch file onto a branch?
      instructions:
      - text: Apply the patch {content} to {owner}/{repo}.
        slots:
          content: requestBody.content
          owner: path.owner
          repo: path.repo
      - text: Apply diff {content} to branch {branch} of {owner}/{repo} with message {message}.
        slots:
          content: requestBody.content
          branch: requestBody.branch
          owner: path.owner
          repo: path.repo
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/editorconfig/{filepath}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a file's EditorConfig settings
      effect: read
      questions:
      - What EditorConfig rules apply to a given file, like indentation and line endings?
      - Can I resolve the .editorconfig definitions for one path at a specific ref?
      instructions:
      - text: Get the EditorConfig definitions for {filepath} in {owner}/{repo}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
      - text: Show the editor settings that apply to {filepath} in {owner}/{repo} at {ref}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/file-contents'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several files by query string
      effect: read
      questions:
      - Can I fetch multiple files at once with a GET request by passing the file list in the query?
      - How do I batch-read files when I can only send GET requests?
      instructions:
      - text: Fetch the files listed in {body} from {owner}/{repo} using the GET variant.
        slots:
          body: query.body
          owner: path.owner
          repo: path.repo
      - text: Batch-read files {body} from {owner}/{repo} at {ref} via query string.
        slots:
          body: query.body
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/file-contents'].post
  update:
    x-apievangelist-phrasing:
      intent: Get several files' contents in one request
      effect: read
      questions:
      - How do I retrieve the content of many files in one request?
      - What happens to files that are too large in a batch file read?
      instructions:
      - text: Read the files {files} from {owner}/{repo} in one POST request.
        slots:
          files: requestBody.files
          owner: path.owner
          repo: path.repo
      - text: Batch-fetch contents of {files} in {owner}/{repo} at ref {ref}.
        slots:
          files: requestBody.files
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/forks'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's forks
      effect: read
      questions:
      - Who has forked a repository?
      - Can I page through all forks of a popular repo?
      instructions:
      - text: List the forks of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every fork created from {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/forks'].post
  update:
    x-apievangelist-phrasing:
      intent: Fork a repository
      effect: write
      questions:
      - How do I fork a repository into my account or an organization?
      - Can I give my fork a different name?
      instructions:
      - text: Fork {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Fork {owner}/{repo} into organization {organization} as {name}.
        slots:
          owner: path.owner
          repo: path.repo
          organization: requestBody.organization
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/blobs/{sha}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a git blob
      effect: read
      questions:
      - How do I fetch a raw git blob object by its SHA?
      - Can I get the base64 content of a blob without knowing its file path?
      instructions:
      - text: Get blob {sha} from {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Fetch the git blob object {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/commits/{sha}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single commit
      effect: read
      questions:
      - How do I look up one commit's author, message and changed files?
      - Can I skip stats or verification info when fetching a commit to make it faster?
      instructions:
      - text: Show commit {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Get commit {sha} in {owner}/{repo} with the changed files list.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/commits/{sha}.{diffType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a commit's diff or patch
      effect: read
      questions:
      - Can I download the raw diff or patch file for one commit?
      - What format options exist for exporting a commit's changes?
      instructions:
      - text: Download the {diffType} for commit {sha} in {owner}/{repo}.
        slots:
          diffType: path.diffType
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Get commit {sha} of {owner}/{repo} as a {diffType} file.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
          diffType: path.diffType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/notes/{sha}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a commit's git note
      effect: read
      questions:
      - Is there a git note attached to a particular commit?
      - How can I read the notes stored against a commit?
      instructions:
      - text: Get the git note for commit {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Show the note attached to {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/refs'].get
  update:
    x-apievangelist-phrasing:
      intent: List all git refs
      effect: read
      questions:
      - What are all the raw git refs in a repository, including heads and tags?
      - Can I dump every reference a repo has?
      instructions:
      - text: List all git refs in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every head and tag reference in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/refs/{ref}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get git refs matching a prefix
      effect: read
      questions:
      - Can I get only the refs matching a given prefix, like heads/feature?
      - What SHA does one specific git ref resolve to?
      instructions:
      - text: Get the git refs matching {ref} in {owner}/{repo}.
        slots:
          ref: path.ref
          owner: path.owner
          repo: path.repo
      - text: Resolve reference {ref} in {owner}/{repo} to its SHA.
        slots:
          ref: path.ref
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/tags/{sha}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an annotated tag object
      effect: read
      questions:
      - How do I read an annotated tag's message and tagger?
      - Does fetching a tag object work for lightweight tags too?
      instructions:
      - text: Get the annotated tag object {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Show the tagger and message of annotated tag {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/git/trees/{sha}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a git tree
      effect: read
      questions:
      - How do I list a git tree, optionally recursively, for a commit or tree SHA?
      - Can I page through a very large tree?
      instructions:
      - text: Get tree {sha} of {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Recursively list tree {sha} in {owner}/{repo} with recursive set to {recursive}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
          recursive: query.recursive
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's webhooks
      effect: read
      questions:
      - Which webhooks are configured on a repository?
      - Can I see where a repo sends its webhook events?
      instructions:
      - text: List the webhooks on {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show all web hooks configured for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a webhook
      effect: write
      questions:
      - How do I set up a webhook so a repo notifies my service on push?
      - Which events can a repository webhook subscribe to, and can I filter by branch?
      instructions:
      - text: Create a {type} webhook on {owner}/{repo} with config {config}.
        slots:
          type: requestBody.type
          owner: path.owner
          repo: path.repo
          config: requestBody.config
      - text: Add a {type} webhook to {owner}/{repo} for events {events} with config {config}.
        slots:
          type: requestBody.type
          owner: path.owner
          repo: path.repo
          events: requestBody.events
          config: requestBody.config
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/git'].get
  update:
    x-apievangelist-phrasing:
      intent: List server-side git hooks
      effect: read
      questions:
      - Which server-side git hooks, like pre-receive, are available on a repository?
      - Can I see the git hooks configured for a repo?
      instructions:
      - text: List the git hooks in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the server-side git hooks for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/git/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a server-side git hook
      effect: read
      questions:
      - How do I view the script of one git hook, like post-receive?
      - Is a specific git hook active on this repository?
      instructions:
      - text: Show git hook {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Get the script content of git hook {id} for {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/git/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a server-side git hook
      effect: destructive
      questions:
      - How do I remove a server-side git hook script?
      - Can I clear a pre-receive hook from a repo?
      instructions:
      - text: Delete git hook {id} from {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Clear the server-side git hook {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/git/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a server-side git hook
      effect: write
      questions:
      - Can I change the script that runs in a repository's git hook?
      - How do I write a new update hook script?
      instructions:
      - text: Set the script of git hook {id} in {owner}/{repo} to {content}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          content: requestBody.content
      - text: Replace git hook {id} in {owner}/{repo} with {content}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          content: requestBody.content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a webhook
      effect: read
      questions:
      - How can I see one webhook's URL, events and active state?
      - What does a specific repository webhook subscribe to?
      instructions:
      - text: Show webhook {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Get the configuration of web hook {id} for {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook
      effect: destructive
      questions:
      - How do I remove a webhook from a repository?
      - Can I stop a repo from sending events to an endpoint permanently?
      instructions:
      - text: Delete webhook {id} from {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Remove the web hook {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a webhook
      effect: write
      questions:
      - Can I deactivate a webhook without deleting it?
      - How do I change which events or branches an existing webhook fires on?
      instructions:
      - text: Update webhook {id} in {owner}/{repo} to fire on {events}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          events: requestBody.events
      - text: Set webhook {id} in {owner}/{repo} active to {active}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          active: requestBody.active
      - text: Limit webhook {id} in {owner}/{repo} to branches {branch_filter}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          branch_filter: requestBody.branch_filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/hooks/{id}/tests'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a test push to a webhook
      effect: write
      questions:
      - How do I test that a webhook endpoint receives push events correctly?
      - Can I fire a test delivery for a specific ref?
      instructions:
      - text: Send a test push delivery to webhook {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Test webhook {id} of {owner}/{repo} using ref {ref}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issue_config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's issue config
      effect: read
      questions:
      - What issue form configuration, such as contact links or blank issues, does a repo use?
      - Are blank issues allowed in this repository?
      instructions:
      - text: Get the issue config of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show whether {owner}/{repo} allows blank issues.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issue_config/validate'].get
  update:
    x-apievangelist-phrasing:
      intent: Validate a repository's issue config
      effect: read
      questions:
      - Is my repo's issue config file valid?
      - What errors are in the issue template configuration?
      instructions:
      - text: Validate the issue config for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Check {owner}/{repo} for issue config errors.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issue_templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List available issue templates
      effect: read
      questions:
      - Which issue templates can people choose from when opening an issue?
      - Does this repository have any issue templates defined?
      instructions:
      - text: List the issue templates of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the available templates for new issues in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/pinned'].get
  update:
    x-apievangelist-phrasing:
      intent: List pinned issues
      effect: read
      questions:
      - Which issues are pinned at the top of a repository?
      - Can I see a repo's pinned issues?
      instructions:
      - text: List the pinned issues in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show issues pinned in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's deploy keys
      effect: read
      questions:
      - Which deploy keys have access to a repository?
      - Can I find a deploy key by its fingerprint?
      instructions:
      - text: List the deploy keys on {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Find the deploy key with fingerprint {fingerprint} in {owner}/{repo}.
        slots:
          fingerprint: query.fingerprint
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a deploy key
      effect: write
      questions:
      - How do I add an SSH deploy key so a server can pull a repo?
      - Can a deploy key be restricted to read-only access?
      instructions:
      - text: Add deploy key {title} with public key {key} to {owner}/{repo}.
        slots:
          title: requestBody.title
          key: requestBody.key
          owner: path.owner
          repo: path.repo
      - text: Add read-only deploy key {title} ({key}) to {owner}/{repo}, read_only {read_only}.
        slots:
          title: requestBody.title
          key: requestBody.key
          owner: path.owner
          repo: path.repo
          read_only: requestBody.read_only
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/keys/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deploy key
      effect: read
      questions:
      - How can I see one deploy key's title, fingerprint and access?
      - Is a given deploy key read-only?
      instructions:
      - text: Show deploy key {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Get details of deploy key {id} on {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/keys/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a deploy key
      effect: destructive
      questions:
      - How do I revoke a deploy key from a repository?
      - Can I delete an SSH key that no longer should access the repo?
      instructions:
      - text: Delete deploy key {id} from {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Revoke deploy key {id} on {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's language breakdown
      effect: read
      questions:
      - Which programming languages is a repository written in?
      - How many bytes of each language are in the codebase?
      instructions:
      - text: Show the language breakdown of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Get bytes of code per language for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/licenses'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's licenses
      effect: read
      questions:
      - What license is a repository published under?
      - Can I detect every license file in a repo?
      instructions:
      - text: Get the licenses of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show which licenses {owner}/{repo} is released under.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/media/{filepath}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a file, resolving LFS objects
      effect: read
      questions:
      - How do I download a file stored in Git LFS rather than its pointer?
      - Can I get the real binary of a large file tracked with LFS?
      instructions:
      - text: Download {filepath} from {owner}/{repo}, resolving the LFS object.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
      - text: Get the LFS media for {filepath} in {owner}/{repo} at {ref}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/merge-upstream'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync a fork with its upstream
      effect: write
      questions:
      - How do I pull the latest upstream changes into my fork's branch?
      - Can I require a fast-forward only when syncing a fork?
      instructions:
      - text: Merge upstream changes into {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Sync branch {branch} of fork {owner}/{repo} from upstream, fast-forward only {ff_only}.
        slots:
          branch: requestBody.branch
          owner: path.owner
          repo: path.repo
          ff_only: requestBody.ff_only
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/mirror-sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync a pull mirror now
      effect: write
      questions:
      - Can I force a mirrored repository to pull from its source right now?
      - How do I refresh a pull mirror without waiting for the interval?
      instructions:
      - text: Sync the mirror {owner}/{repo} now.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Trigger a pull mirror update for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/new_pin_allowed'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if more issues can be pinned
      effect: read
      questions:
      - Can I pin another issue or pull request in this repo, or is the limit reached?
      - Is there room for a new pinned issue?
      instructions:
      - text: Check whether new pins are allowed in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Tell me if {owner}/{repo} can take another pinned issue.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's pull requests
      effect: read
      questions:
      - How do I list the open pull requests in a repository?
      - Can I filter pull requests by base branch, label, milestone or author?
      - Which PRs were closed recently?
      instructions:
      - text: List open pull requests in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show pull requests in {owner}/{repo} with state {state} targeting {base_branch}.
        slots:
          owner: path.owner
          repo: path.repo
          state: query.state
          base_branch: query.base_branch
      - text: List PRs in {owner}/{repo} opened by {poster}.
        slots:
          owner: path.owner
          repo: path.repo
          poster: query.poster
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls'].post
  update:
    x-apievangelist-phrasing:
      intent: Open a pull request
      effect: write
      questions:
      - How do I open a pull request from one branch into another?
      - Can I set reviewers, labels and a milestone when I create a PR?
      instructions:
      - text: Open a pull request in {owner}/{repo} from {head} into {base} titled {title}.
        slots:
          owner: path.owner
          repo: path.repo
          head: requestBody.head
          base: requestBody.base
          title: requestBody.title
      - text: Create a PR in {owner}/{repo} from {head} to {base} titled {title} and request {reviewers}.
        slots:
          owner: path.owner
          repo: path.repo
          head: requestBody.head
          base: requestBody.base
          title: requestBody.title
          reviewers: requestBody.reviewers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/comments/{id}/resolve'].post
  update:
    x-apievangelist-phrasing:
      intent: Resolve a review comment
      effect: write
      questions:
      - How do I mark a pull request review comment as resolved?
      - Can I resolve a code review conversation once it's addressed?
      instructions:
      - text: Resolve review comment {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Mark PR review comment {id} in {owner}/{repo} as resolved.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/comments/{id}/unresolve'].post
  update:
    x-apievangelist-phrasing:
      intent: Unresolve a review comment
      effect: write
      questions:
      - Can I reopen a review comment thread that was marked resolved?
      - How do I unresolve a pull request conversation?
      instructions:
      - text: Unresolve review comment {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Reopen the resolved PR review comment {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/pinned'].get
  update:
    x-apievangelist-phrasing:
      intent: List pinned pull requests
      effect: read
      questions:
      - Which pull requests are pinned in a repository?
      - Can I see only the PRs pinned to the top?
      instructions:
      - text: List the pinned pull requests in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show PRs pinned in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{base}/{head}'].get
  update:
    x-apievangelist-phrasing:
      intent: Find a pull request by base and head
      effect: read
      questions:
      - Is there already a pull request from a given branch into another?
      - How do I look up a PR when I know only its base and head branches?
      instructions:
      - text: Find the pull request from {head} into {base} in {owner}/{repo}.
        slots:
          head: path.head
          base: path.base
          owner: path.owner
          repo: path.repo
      - text: Get the PR with base {base} and head {head} in {owner}/{repo}.
        slots:
          base: path.base
          head: path.head
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pull request
      effect: read
      questions:
      - How can I see the status, branches and mergeability of one pull request?
      - Is a given PR still open or already merged?
      instructions:
      - text: 'Show pull request #{index} in {owner}/{repo}.'
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Get details of PR {index} in {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a pull request
      effect: write
      questions:
      - Can I change a pull request's title, description or target branch after opening it?
      - How do I close a PR without merging it?
      - Is it possible to set a due date on a pull request?
      instructions:
      - text: Change the title of PR {index} in {owner}/{repo} to {title}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          title: requestBody.title
      - text: Close pull request {index} in {owner}/{repo} by setting state to {state}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          state: requestBody.state
      - text: Retarget PR {index} in {owner}/{repo} to base {base}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          base: requestBody.base
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}.{diffType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a pull request's diff or patch
      effect: read
      questions:
      - Can I download a pull request as a raw diff or patch file?
      - Does a PR diff download include binary changes?
      instructions:
      - text: Download PR {index} of {owner}/{repo} as a {diffType}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          diffType: path.diffType
      - text: Get the {diffType} for pull request {index} in {owner}/{repo} including binary {binary}.
        slots:
          diffType: path.diffType
          index: path.index
          owner: path.owner
          repo: path.repo
          binary: query.binary
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/commits'].get
  update:
    x-apievangelist-phrasing:
      intent: List a pull request's commits
      effect: read
      questions:
      - Which commits are included in a pull request?
      - Can I see the commits of a PR with their changed files?
      instructions:
      - text: List the commits in PR {index} of {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Show commits on pull request {index} in {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List files changed in a pull request
      effect: read
      questions:
      - What files does a pull request change?
      - Can I ignore whitespace-only changes when listing a PR's files?
      instructions:
      - text: List the changed files in PR {index} of {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Show files changed by pull request {index} in {owner}/{repo} with whitespace mode {whitespace}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          whitespace: query.whitespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/merge'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a pull request is merged
      effect: read
      questions:
      - Has a particular pull request been merged yet?
      - Can I quickly confirm a PR's merge status?
      instructions:
      - text: Check whether PR {index} in {owner}/{repo} has been merged.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Confirm the merge status of pull request {index} in {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/merge'].post
  update:
    x-apievangelist-phrasing:
      intent: Merge a pull request
      effect: write
      questions:
      - How do I merge a pull request with squash or rebase instead of a merge commit?
      - Can I schedule a PR to merge automatically once checks succeed?
      - Will merging delete the head branch afterwards if I ask it to?
      instructions:
      - text: Merge pull request {index} in {owner}/{repo} using {do}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          do: requestBody.do
      - text: Squash-merge PR {index} in {owner}/{repo} with style {do} and title {merge_title_field}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          do: requestBody.do
          merge_title_field: requestBody.merge_title_field
      - text: Merge PR {index} in {owner}/{repo} via {do} when checks pass, setting {merge_when_checks_succeed}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          do: requestBody.do
          merge_when_checks_succeed: requestBody.merge_when_checks_succeed
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/merge'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel a scheduled auto-merge
      effect: destructive
      questions:
      - How do I stop a pull request from auto-merging when checks pass?
      - Can I cancel an auto-merge I scheduled earlier?
      instructions:
      - text: Cancel the scheduled auto-merge for PR {index} in {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Stop pull request {index} in {owner}/{repo} from merging automatically.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/requested_reviewers'].post
  update:
    x-apievangelist-phrasing:
      intent: Request reviewers on a pull request
      effect: write
      questions:
      - How do I ask specific people or teams to review a pull request?
      - Can I request a team review on a PR that's already open?
      instructions:
      - text: Request reviews from {reviewers} on PR {index} in {owner}/{repo}.
        slots:
          reviewers: requestBody.reviewers
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Ask team {team_reviewers} to review pull request {index} in {owner}/{repo}.
        slots:
          team_reviewers: requestBody.team_reviewers
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/requested_reviewers'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel review requests on a pull request
      effect: destructive
      questions:
      - Can I withdraw a review request I sent to someone on a PR?
      - How do I remove a team from a pull request's requested reviewers?
      instructions:
      - text: Cancel the review request for {reviewers} on PR {index} in {owner}/{repo}.
        slots:
          reviewers: requestBody.reviewers
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Remove team {team_reviewers} from requested reviewers on PR {index} in {owner}/{repo}.
        slots:
          team_reviewers: requestBody.team_reviewers
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews'].get
  update:
    x-apievangelist-phrasing:
      intent: List a pull request's reviews
      effect: read
      questions:
      - Who has reviewed a pull request and did they approve or request changes?
      - Can I list every review submitted on a PR?
      instructions:
      - text: List the reviews on PR {index} in {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Show all approvals and change requests for pull request {index} in {owner}/{repo}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a pull request review
      effect: write
      questions:
      - How do I leave a review with inline code comments on a pull request?
      - Can I approve or request changes when creating a review?
      instructions:
      - text: Create a review on PR {index} in {owner}/{repo} with event {event} and body {body}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          event: requestBody.event
          body: requestBody.body
      - text: Review PR {index} in {owner}/{repo} with inline comments {comments}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          comments: requestBody.comments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pull request review
      effect: read
      questions:
      - How can I read the state and summary of one specific review on a PR?
      - Was a particular review an approval?
      instructions:
      - text: Show review {id} on PR {index} in {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Get the state of review {id} for pull request {index} in {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a pending review
      effect: write
      questions:
      - I started a pending review; how do I submit it?
      - Can I choose approve or request changes when submitting a draft review?
      instructions:
      - text: Submit pending review {id} on PR {index} in {owner}/{repo} as {event}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
          event: requestBody.event
      - text: Finish draft review {id} on pull request {index} in {owner}/{repo} with {event} and {body}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
          event: requestBody.event
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a pull request review
      effect: destructive
      questions:
      - Can I delete a review I left on a pull request?
      - How do I remove a pending review?
      instructions:
      - text: Delete review {id} from PR {index} in {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Remove pull request review {id} on PR {index} of {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/comments'].get
  update:
    x-apievangelist-phrasing:
      intent: List a review's inline comments
      effect: read
      questions:
      - What inline code comments were left as part of one review?
      - Can I read every line comment from a specific PR review?
      instructions:
      - text: List the comments in review {id} on PR {index} of {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Show inline code comments from review {id} of pull request {index} in {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/dismissals'].post
  update:
    x-apievangelist-phrasing:
      intent: Dismiss a pull request review
      effect: write
      questions:
      - How do I dismiss a stale or blocking review on a PR?
      - Can I leave a message explaining why a review was dismissed?
      instructions:
      - text: Dismiss review {id} on PR {index} in {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Dismiss review {id} on pull request {index} of {owner}/{repo} with message {message}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/undismissals'].post
  update:
    x-apievangelist-phrasing:
      intent: Undo a review dismissal
      effect: write
      questions:
      - Can I restore a review that was dismissed by mistake?
      - How do I cancel a dismissal on a PR review?
      instructions:
      - text: Undismiss review {id} on PR {index} in {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Restore dismissed review {id} on pull request {index} of {owner}/{repo}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/pulls/{index}/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a PR branch from its base
      effect: write
      questions:
      - How do I bring a pull request's branch up to date with the base branch?
      - Can I rebase the head branch instead of merging the base into it?
      instructions:
      - text: Update the branch of PR {index} in {owner}/{repo} with its base.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Bring PR {index} in {owner}/{repo} up to date using style {style}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          style: query.style
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/push_mirrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List push mirrors
      effect: read
      questions:
      - Which remote push mirrors is a repository replicating to?
      - Can I see all push mirror destinations for a repo?
      instructions:
      - text: List the push mirrors of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every remote {owner}/{repo} push-mirrors to.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/push_mirrors'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a push mirror
      effect: write
      questions:
      - How do I make a repository automatically push to another remote?
      - Can a push mirror sync on every commit or on an interval?
      instructions:
      - text: Add a push mirror from {owner}/{repo} to {remote_address}.
        slots:
          owner: path.owner
          repo: path.repo
          remote_address: requestBody.remote_address
      - text: Push-mirror {owner}/{repo} to {remote_address} every {interval}, sync on commit {sync_on_commit}.
        slots:
          owner: path.owner
          repo: path.repo
          remote_address: requestBody.remote_address
          interval: requestBody.interval
          sync_on_commit: requestBody.sync_on_commit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/push_mirrors-sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync all push mirrors now
      effect: write
      questions:
      - Can I push a repo to all of its mirrors immediately?
      - How do I trigger every push mirror to sync right away?
      instructions:
      - text: Sync all push mirrors of {owner}/{repo} now.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Push {owner}/{repo} to every configured push mirror.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/push_mirrors/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a push mirror by remote name
      effect: read
      questions:
      - How do I check the status of one push mirror, like its last update or error?
      - Where does a given push mirror remote point?
      instructions:
      - text: Show push mirror {name} of {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      - text: Get last sync status of the push mirror remote {name} in {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/push_mirrors/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a push mirror
      effect: destructive
      questions:
      - How do I stop a repository from pushing to a mirror?
      - Can I delete a push mirror by its remote name?
      instructions:
      - text: Delete push mirror {name} from {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      - text: Remove the push mirror remote {name} in {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/raw/{filepath}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a raw file
      effect: read
      questions:
      - How do I get the raw bytes of a file in a repository?
      - Can I download a raw file from a given branch, tag or commit?
      instructions:
      - text: Download the raw file {filepath} from {owner}/{repo}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
      - text: Get raw {filepath} in {owner}/{repo} at ref {ref}.
        slots:
          filepath: path.filepath
          owner: path.owner
          repo: path.repo
          ref: query.ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's releases
      effect: read
      questions:
      - What releases has a project published?
      - Can I exclude drafts or pre-releases when listing releases?
      instructions:
      - text: List the releases of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show releases in {owner}/{repo} with pre-release set to {pre-release}.
        slots:
          owner: path.owner
          repo: path.repo
          pre-release: query.pre-release
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a release
      effect: write
      questions:
      - How do I publish a new release for a tag?
      - Can I create a release as a draft or mark it as a pre-release?
      instructions:
      - text: Create release {tag_name} in {owner}/{repo}.
        slots:
          tag_name: requestBody.tag_name
          owner: path.owner
          repo: path.repo
      - text: Create draft release {name} for tag {tag_name} in {owner}/{repo} with notes {body}.
        slots:
          name: requestBody.name
          tag_name: requestBody.tag_name
          owner: path.owner
          repo: path.repo
          body: requestBody.body
      - text: Publish pre-release {tag_name} of {owner}/{repo} targeting {target_commitish}.
        slots:
          tag_name: requestBody.tag_name
          owner: path.owner
          repo: path.repo
          target_commitish: requestBody.target_commitish
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/latest'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the latest release
      effect: read
      questions:
      - What's the most recent stable release of a project?
      - Does the latest-release lookup skip drafts and pre-releases?
      instructions:
      - text: Get the latest release of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the newest stable release published by {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/tags/{tag}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a release by tag name
      effect: read
      questions:
      - How do I find the release associated with a specific version tag?
      - Can I look up release notes using the tag, like v1.2.0?
      instructions:
      - text: Get the release for tag {tag} in {owner}/{repo}.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      - text: Show release notes for tag {tag} of {owner}/{repo}.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/tags/{tag}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a release by tag name
      effect: destructive
      questions:
      - Can I delete a release by its tag name instead of its numeric id?
      - How do I remove the release for a given version tag?
      instructions:
      - text: Delete the release tagged {tag} in {owner}/{repo}.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      - text: Remove the release for tag {tag} from {owner}/{repo}, looked up by tag name.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a release by id
      effect: read
      questions:
      - How do I fetch a release's details when I have its numeric id?
      - What assets and notes does a particular release id have?
      instructions:
      - text: Get release {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Show details of release id {id} for {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a release by id
      effect: destructive
      questions:
      - How do I delete a release using its numeric id?
      - Does deleting a release by id also remove its tag?
      instructions:
      - text: Delete release {id} from {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Remove release id {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a release
      effect: write
      questions:
      - Can I edit a release's notes or title after publishing it?
      - How do I turn a draft release into a published one?
      instructions:
      - text: Update the notes of release {id} in {owner}/{repo} to {body}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          body: requestBody.body
      - text: Publish draft release {id} in {owner}/{repo} by setting draft to {draft}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          draft: requestBody.draft
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}/assets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a release's attachments
      effect: read
      questions:
      - What downloadable files are attached to a release?
      - Can I list the binaries uploaded to one release?
      instructions:
      - text: List the attachments of release {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Show files attached to release {id} of {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a release attachment
      effect: write
      questions:
      - How do I upload a binary or zip to a release?
      - Can I give an uploaded release asset a custom file name?
      instructions:
      - text: Upload {attachment} to release {id} of {owner}/{repo}.
        slots:
          attachment: requestBody.attachment
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Attach {attachment} to release {id} in {owner}/{repo} named {name}.
        slots:
          attachment: requestBody.attachment
          id: path.id
          owner: path.owner
          repo: path.repo
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a release attachment
      effect: read
      questions:
      - How can I see the size and download count of one release asset?
      - Where is the download URL for a specific release attachment?
      instructions:
      - text: Show attachment {attachment_id} on release {id} in {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Get the download URL of asset {attachment_id} from release {id} of {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a release attachment
      effect: destructive
      questions:
      - Can I remove a wrong file I uploaded to a release?
      - How do I delete one asset from a release?
      instructions:
      - text: Delete attachment {attachment_id} from release {id} in {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Remove asset {attachment_id} on release {id} of {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a release attachment
      effect: write
      questions:
      - Can I rename a file attached to a release?
      - How do I fix the name of an uploaded release asset?
      instructions:
      - text: Rename attachment {attachment_id} on release {id} in {owner}/{repo} to {name}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      - text: Change asset {attachment_id} of release {id} in {owner}/{repo} to be called {name}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/reviewers'].get
  update:
    x-apievangelist-phrasing:
      intent: List users who can review pull requests
      effect: read
      questions:
      - Who can I request a pull request review from in this repository?
      - Which users are eligible reviewers for PRs here?
      instructions:
      - text: List the possible reviewers for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show users who can be asked to review PRs in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/signing-key.gpg'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the repository GPG signing key
      effect: read
      questions:
      - What GPG key does the server use to sign commits in this repository?
      - How can I get the public key to verify commits the instance signs?
      instructions:
      - text: Get the GPG signing key for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Download signing-key.gpg for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/signing-key.pub'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the repository SSH signing key
      effect: read
      questions:
      - Which SSH public key signs commits made by the server in a repo?
      - Can I fetch the SSH signing key to verify signed commits?
      instructions:
      - text: Get the SSH signing key for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Download signing-key.pub for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/stargazers'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's stargazers
      effect: read
      questions:
      - Who has starred a repository?
      - Can I page through the list of users who starred a repo?
      instructions:
      - text: List the stargazers of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show everyone who starred {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/statuses/{sha}'].get
  update:
    x-apievangelist-phrasing:
      intent: List statuses for a commit SHA
      effect: read
      questions:
      - Which CI statuses were reported on one exact commit SHA?
      - Can I sort or filter the statuses of a commit by state?
      instructions:
      - text: List the statuses on commit {sha} in {owner}/{repo}.
        slots:
          sha: path.sha
          owner: path.owner
          repo: path.repo
      - text: Show {state} statuses reported for commit sha {sha} in {owner}/{repo}.
        slots:
          state: query.state
          sha: path.sha
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/statuses/{sha}'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a commit status
      effect: write
      questions:
      - How does my CI system mark a commit as pending, success or failure?
      - Can I attach a link to build details when posting a status?
      instructions:
      - text: Set status {state} on commit {sha} in {owner}/{repo} for context {context}.
        slots:
          state: requestBody.state
          sha: path.sha
          owner: path.owner
          repo: path.repo
          context: requestBody.context
      - text: Report {state} on {sha} in {owner}/{repo} with target URL {target_url} and description {description}.
        slots:
          state: requestBody.state
          sha: path.sha
          owner: path.owner
          repo: path.repo
          target_url: requestBody.target_url
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/subscribers'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's watchers
      effect: read
      questions:
      - Who is watching a repository for notifications?
      - How many people follow changes to this repo?
      instructions:
      - text: List the watchers of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show users subscribed to notifications from {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/subscription'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if I'm watching a repository
      effect: read
      questions:
      - Am I currently watching this repository?
      - Can I verify whether I'm subscribed to a repo's notifications?
      instructions:
      - text: Check if I'm watching {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Tell me whether my account is subscribed to {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/subscription'].put
  update:
    x-apievangelist-phrasing:
      intent: Watch a repository
      effect: write
      questions:
      - How do I start watching a repository to get notifications?
      - Can I subscribe to all activity on a repo?
      instructions:
      - text: Watch {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Subscribe me to notifications for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/subscription'].delete
  update:
    x-apievangelist-phrasing:
      intent: Stop watching a repository
      effect: destructive
      questions:
      - How do I stop getting notifications from a repo I'm watching?
      - Can I unwatch a repository?
      instructions:
      - text: Unwatch {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Unsubscribe me from {owner}/{repo} notifications.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tag_protections'].get
  update:
    x-apievangelist-phrasing:
      intent: List tag protection rules
      effect: read
      questions:
      - Which tag protection rules does a repository have?
      - Who is allowed to create protected tags here?
      instructions:
      - text: List the tag protections for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show all tag protection rules in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tag_protections'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tag protection rule
      effect: write
      questions:
      - How do I stop anyone but release managers from creating version tags?
      - Can a tag protection rule match a pattern like v*?
      instructions:
      - text: Protect tags matching {name_pattern} in {owner}/{repo}.
        slots:
          name_pattern: requestBody.name_pattern
          owner: path.owner
          repo: path.repo
      - text: Create tag protection {name_pattern} in {owner}/{repo} allowing users {whitelist_usernames}.
        slots:
          name_pattern: requestBody.name_pattern
          owner: path.owner
          repo: path.repo
          whitelist_usernames: requestBody.whitelist_usernames
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tag_protections/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag protection rule
      effect: read
      questions:
      - What pattern and allowlist does one tag protection rule have?
      - Which teams may push tags under a given protection rule?
      instructions:
      - text: Show tag protection {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Get the pattern and allowlist of tag protection {id} for {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tag_protections/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag protection rule
      effect: destructive
      questions:
      - How do I remove a tag protection rule?
      - Can I unprotect tags that match a pattern?
      instructions:
      - text: Delete tag protection {id} from {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Remove tag protection rule {id} in {owner}/{repo}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tag_protections/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a tag protection rule
      effect: write
      questions:
      - Can I change the pattern or allowed teams on an existing tag protection?
      - How do I add a user to a tag protection allowlist?
      instructions:
      - text: Change tag protection {id} in {owner}/{repo} to pattern {name_pattern}.
        slots:
          id: path.id
          owner: path.owner
          repo: path.repo
          name_pattern: requestBody.name_pattern
      - text: Allow teams {whitelist_teams} under tag protection {id} in {owner}/{repo}.
        slots:
          whitelist_teams: requestBody.whitelist_teams
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's tags
      effect: read
      questions:
      - What tags exist in a repository?
      - Can I page through all version tags of a project?
      instructions:
      - text: List the tags in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show {limit} tags per page from {owner}/{repo}.
        slots:
          limit: query.limit
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a git tag
      effect: write
      questions:
      - How do I tag a commit with a version number?
      - Can I create an annotated tag with a message on a specific branch or commit?
      instructions:
      - text: Create tag {tag_name} in {owner}/{repo}.
        slots:
          tag_name: requestBody.tag_name
          owner: path.owner
          repo: path.repo
      - text: Tag {target} in {owner}/{repo} as {tag_name} with message {message}.
        slots:
          target: requestBody.target
          owner: path.owner
          repo: path.repo
          tag_name: requestBody.tag_name
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tags/{tag}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag by name
      effect: read
      questions:
      - Which commit does a particular tag point to?
      - How do I look up a tag's details by its name?
      instructions:
      - text: Show tag {tag} in {owner}/{repo}.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      - text: Get the commit that tag {tag} points at in {owner}/{repo}.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/tags/{tag}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a git tag
      effect: destructive
      questions:
      - How do I delete a git tag from a repository?
      - Can I remove a tag that was pushed by mistake?
      instructions:
      - text: Delete tag {tag} from {owner}/{repo}.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      - text: Remove the git tag {tag} in {owner}/{repo}.
        slots:
          tag: path.tag
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: List teams with access to a repository
      effect: read
      questions:
      - Which organization teams have access to a repository?
      - Can I see all teams assigned to a repo?
      instructions:
      - text: List the teams on {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every team with access to {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/teams/{team}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a team is assigned to a repository
      effect: read
      questions:
      - Does a particular team have access to this repository?
      - Is a given team already assigned to a repo?
      instructions:
      - text: Check whether team {team} is assigned to {owner}/{repo}.
        slots:
          team: path.team
          owner: path.owner
          repo: path.repo
      - text: Confirm team {team} has access to {owner}/{repo}.
        slots:
          team: path.team
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/teams/{team}'].put
  update:
    x-apievangelist-phrasing:
      intent: Give a team access to a repository
      effect: write
      questions:
      - How do I grant an organization team access to a repo?
      - Can I assign a team to a repository?
      instructions:
      - text: Add team {team} to {owner}/{repo}.
        slots:
          team: path.team
          owner: path.owner
          repo: path.repo
      - text: Grant team {team} access to {owner}/{repo}.
        slots:
          team: path.team
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/teams/{team}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a team from a repository
      effect: destructive
      questions:
      - How do I take a team's access away from a repository?
      - Can I unassign a team from a repo?
      instructions:
      - text: Remove team {team} from {owner}/{repo}.
        slots:
          team: path.team
          owner: path.owner
          repo: path.repo
      - text: Revoke team {team}'s access to {owner}/{repo}.
        slots:
          team: path.team
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/times'].get
  update:
    x-apievangelist-phrasing:
      intent: List time tracked in a repository
      effect: read
      questions:
      - How much time has been logged on issues in a repository?
      - Can I filter tracked time by user or by a date range?
      instructions:
      - text: List the tracked times in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show time tracked in {owner}/{repo} by {user} since {since}.
        slots:
          owner: path.owner
          repo: path.repo
          user: query.user
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/times/{user}'].get
  update:
    x-apievangelist-phrasing:
      intent: List one user's tracked time in a repo
      effect: read
      questions:
      - How much time did a specific person log in one repository?
      - Can I get a single user's time entries for a repo?
      instructions:
      - text: List the time entries for user {user} in {owner}/{repo}.
        slots:
          user: path.user
          owner: path.owner
          repo: path.repo
      - text: Show what {user} has tracked on {owner}/{repo} via their dedicated times endpoint.
        slots:
          user: path.user
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/topics'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's topics
      effect: read
      questions:
      - Which topics is a repository tagged with?
      - Can I see the topic labels on a repo?
      instructions:
      - text: List the topics of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show topic tags applied to {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/topics'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all of a repository's topics
      effect: write
      questions:
      - Can I set a repository's full list of topics in one go?
      - How do I overwrite every topic on a repo with a new set?
      instructions:
      - text: Replace the topics of {owner}/{repo} with {topics}.
        slots:
          owner: path.owner
          repo: path.repo
          topics: requestBody.topics
      - text: Set the full topic list of {owner}/{repo} to {topics}.
        slots:
          owner: path.owner
          repo: path.repo
          topics: requestBody.topics
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/topics/{topic}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a topic to a repository
      effect: write
      questions:
      - How do I add one more topic to a repository?
      - Can I tag a repo with a single new topic without touching the others?
      instructions:
      - text: Add topic {topic} to {owner}/{repo}.
        slots:
          topic: path.topic
          owner: path.owner
          repo: path.repo
      - text: Tag {owner}/{repo} with the topic {topic}.
        slots:
          owner: path.owner
          repo: path.repo
          topic: path.topic
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/topics/{topic}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a topic from a repository
      effect: destructive
      questions:
      - How do I remove one topic from a repo?
      - Can I untag a repository from a topic?
      instructions:
      - text: Remove topic {topic} from {owner}/{repo}.
        slots:
          topic: path.topic
          owner: path.owner
          repo: path.repo
      - text: Delete the topic {topic} on {owner}/{repo}.
        slots:
          topic: path.topic
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/transfer'].post
  update:
    x-apievangelist-phrasing:
      intent: Transfer repository ownership
      effect: write
      questions:
      - How do I move a repository to another user or organization?
      - Can I choose which teams get access when transferring a repo to an org?
      instructions:
      - text: Transfer {owner}/{repo} to {new_owner}.
        slots:
          owner: path.owner
          repo: path.repo
          new_owner: requestBody.new_owner
      - text: Move {owner}/{repo} to organization {new_owner} and give teams {team_ids} access.
        slots:
          owner: path.owner
          repo: path.repo
          new_owner: requestBody.new_owner
          team_ids: requestBody.team_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/transfer/accept'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a repository transfer
      effect: write
      questions:
      - Someone wants to transfer a repo to me; how do I accept it?
      - Can I approve a pending repository transfer?
      instructions:
      - text: Accept the pending transfer of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Approve the transfer of {owner}/{repo} to me.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/transfer/reject'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a repository transfer
      effect: write
      questions:
      - How do I decline a repository someone tried to transfer to me?
      - Can I refuse a pending repo transfer?
      instructions:
      - text: Reject the pending transfer of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Decline the transfer of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/wiki/new'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a wiki page
      effect: write
      questions:
      - How do I add a new page to a repository's wiki?
      - Does a new wiki page's content need to be base64 encoded?
      instructions:
      - text: Create wiki page {title} in {owner}/{repo} with content {content_base64}.
        slots:
          title: requestBody.title
          owner: path.owner
          repo: path.repo
          content_base64: requestBody.content_base64
      - text: Add a new wiki page {title} to {owner}/{repo} with commit message {message}.
        slots:
          title: requestBody.title
          owner: path.owner
          repo: path.repo
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/wiki/page/{pageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a wiki page
      effect: read
      questions:
      - How do I read the content of one wiki page?
      - Who last edited a specific wiki page?
      instructions:
      - text: Show wiki page {pageName} in {owner}/{repo}.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
      - text: Get the content of the {pageName} wiki page for {owner}/{repo}.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/wiki/page/{pageName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a wiki page
      effect: destructive
      questions:
      - How do I delete a page from a repository wiki?
      - Can I remove an outdated wiki page?
      instructions:
      - text: Delete wiki page {pageName} from {owner}/{repo}.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
      - text: Remove the {pageName} page from the wiki of {owner}/{repo}.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/wiki/page/{pageName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a wiki page
      effect: write
      questions:
      - Can I update the text or title of an existing wiki page?
      - How do I rename a wiki page?
      instructions:
      - text: Update wiki page {pageName} in {owner}/{repo} with {content_base64}.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
          content_base64: requestBody.content_base64
      - text: Rename wiki page {pageName} in {owner}/{repo} to {title}.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
          title: requestBody.title
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/wiki/pages'].get
  update:
    x-apievangelist-phrasing:
      intent: List wiki pages
      effect: read
      questions:
      - What pages does a repository's wiki contain?
      - Can I page through all wiki pages of a repo?
      instructions:
      - text: List the wiki pages of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every page in the {owner}/{repo} wiki.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/wiki/revisions/{pageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a wiki page's revisions
      effect: read
      questions:
      - What is the edit history of a wiki page?
      - Can I see who changed a wiki page and when?
      instructions:
      - text: List the revisions of wiki page {pageName} in {owner}/{repo}.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
      - text: Show edit history for {pageName} in the {owner}/{repo} wiki.
        slots:
          pageName: path.pageName
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{template_owner}/{template_repo}/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a repository from a template
      effect: write
      questions:
      - How do I create a new repository from a template repo?
      - Can I copy a template's labels, webhooks and git hooks into the new repo?
      instructions:
      - text: Generate repository {name} for {owner} from template {template_owner}/{template_repo}.
        slots:
          name: requestBody.name
          owner: requestBody.owner
          template_owner: path.template_owner
          template_repo: path.template_repo
      - text: Create {owner}/{name} from template {template_owner}/{template_repo} including git content {git_content}.
        slots:
          owner: requestBody.owner
          name: requestBody.name
          template_owner: path.template_owner
          template_repo: path.template_repo
          git_content: requestBody.git_content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repositories/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository by numeric id
      effect: read
      questions:
      - Can I look up a repository when I only have its numeric id?
      - How do I resolve a repo id to its owner and name?
      instructions:
      - text: Get the repository with id {id}.
        slots:
          id: path.id
      - text: Find which repo has numeric id {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/topics/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search repository topics
      effect: read
      questions:
      - Which topics exist on the instance that match a keyword?
      - Can I look up topic names before tagging a repo?
      instructions:
      - text: Search topics for {q}.
        slots:
          q: query.q
      - text: Find repository topics matching the keyword {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a repository for myself
      effect: write
      questions:
      - How do I create a new repository under my own account?
      - Can I initialize a new repo with a README, license and .gitignore?
      - Is it possible to create a private repository with a different default branch?
      instructions:
      - text: Create a repository named {name}.
        slots:
          name: requestBody.name
      - text: Create private repo {name} with visibility private set to {private}.
        slots:
          name: requestBody.name
          private: requestBody.private
      - text: Create repo {name} initialized with license {license} and gitignore {gitignores}.
        slots:
          name: requestBody.name
          license: requestBody.license
          gitignores: requestBody.gitignores
      method: generated
      generated: '2026-09-26'