# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for GitHub v3 REST Actions API
  version: 1.0.0
extends: openapi/github-actions-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 137
- target: $.paths['/enterprises/{enterprise}/actions/cache/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Check Actions cache usage for an enterprise
      effect: read
      questions:
      - How much GitHub Actions cache storage is my whole enterprise using right now?
      - Is enterprise-wide Actions cache usage data real time, or delayed by a few minutes?
      instructions:
      - text: Show total Actions cache usage across enterprise {enterprise}.
        slots:
          enterprise: path.enterprise
      - text: Tell me how many active caches enterprise {enterprise} has and their total size.
        slots:
          enterprise: path.enterprise
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprises/{enterprise}/actions/cache/usage-policy'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the enterprise Actions cache size policy
      effect: read
      questions:
      - What cache size limit do repos in my enterprise get for GitHub Actions by default?
      - Which maximum repo cache size has my enterprise set as its Actions policy?
      instructions:
      - text: Get the Actions cache usage policy for enterprise {enterprise}.
        slots:
          enterprise: path.enterprise
      - text: Show the default and maximum repo cache size limits configured for enterprise {enterprise}.
        slots:
          enterprise: path.enterprise
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprises/{enterprise}/actions/cache/usage-policy'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set the enterprise Actions cache size policy
      effect: write
      questions:
      - Can I raise the default Actions cache size limit for every repo in my enterprise?
      - How do I cap how large a repository's Actions cache can be enterprise-wide?
      instructions:
      - text: Set the default repo Actions cache limit for enterprise {enterprise} to {repo_cache_size_limit_in_gb} GB.
        slots:
          enterprise: path.enterprise
          repo_cache_size_limit_in_gb: requestBody.repo_cache_size_limit_in_gb
      - text: Cap the maximum repo cache size in enterprise {enterprise} at {max_repo_cache_size_limit_in_gb} GB.
        slots:
          enterprise: path.enterprise
          max_repo_cache_size_limit_in_gb: requestBody.max_repo_cache_size_limit_in_gb
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprises/{enterprise}/actions/permissions/workflow'].get
  update:
    x-apievangelist-phrasing:
      intent: Get default GITHUB_TOKEN permissions for an enterprise
      effect: read
      questions:
      - What permissions does GITHUB_TOKEN get by default in workflows across my enterprise?
      - Are Actions workflows in my enterprise allowed to approve pull requests?
      instructions:
      - text: Show the default workflow token permissions for enterprise {enterprise}.
        slots:
          enterprise: path.enterprise
      - text: Check whether Actions can approve pull request reviews in enterprise {enterprise}.
        slots:
          enterprise: path.enterprise
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprises/{enterprise}/actions/permissions/workflow'].put
  update:
    x-apievangelist-phrasing:
      intent: Set default GITHUB_TOKEN permissions for an enterprise
      effect: write
      questions:
      - Can I make GITHUB_TOKEN read-only by default for every workflow in my enterprise?
      - How do I stop Actions from approving pull requests anywhere in my enterprise?
      instructions:
      - text: Set the default workflow token permissions for enterprise {enterprise} to {default_workflow_permissions}.
        slots:
          enterprise: path.enterprise
          default_workflow_permissions: requestBody.default_workflow_permissions
      - text: Set whether Actions can approve pull request reviews in enterprise {enterprise} to {can_approve_pull_request_reviews}.
        slots:
          enterprise: path.enterprise
          can_approve_pull_request_reviews: requestBody.can_approve_pull_request_reviews
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/cache/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Check Actions cache usage for an organization
      effect: read
      questions:
      - How much Actions cache storage is my organization using in total?
      - What is the combined size of all active GitHub Actions caches in my org?
      instructions:
      - text: Show total Actions cache usage for organization {org}.
        slots:
          org: path.org
      - text: Tell me the org-wide Actions cache count and size for {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/cache/usage-by-repository'].get
  update:
    x-apievangelist-phrasing:
      intent: List repos by Actions cache usage in an org
      effect: read
      questions:
      - Which repositories in my organization are using the most Actions cache?
      - Can I see a per-repository breakdown of Actions cache usage across my org?
      instructions:
      - text: List each repository's Actions cache usage in organization {org}.
        slots:
          org: path.org
      - text: Show page {page} of the per-repo Actions cache breakdown for {org}.
        slots:
          page: query.page
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Actions permissions policy for an org
      effect: read
      questions:
      - Which repositories in my organization are allowed to run GitHub Actions?
      - 'What actions policy does my org apply to repos: all actions, local only, or selected?'
      instructions:
      - text: Get the Actions permissions policy for organization {org}.
        slots:
          org: path.org
      - text: Show which repos and which actions are allowed to run in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the Actions permissions policy for an org
      effect: write
      questions:
      - Can I turn GitHub Actions on for only selected repositories in my organization?
      - How do I restrict my org so only certain actions are allowed to run?
      instructions:
      - text: Set Actions in organization {org} to run in {enabled_repositories} repositories.
        slots:
          org: path.org
          enabled_repositories: requestBody.enabled_repositories
      - text: Enable Actions for {enabled_repositories} repos in {org} and allow {allowed_actions} actions.
        slots:
          enabled_repositories: requestBody.enabled_repositories
          org: path.org
          allowed_actions: requestBody.allowed_actions
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List repos enabled for Actions in an org
      effect: read
      questions:
      - Which specific repositories have been picked to run Actions in my org?
      - When my org enables Actions for selected repos only, how do I see that list?
      instructions:
      - text: List the repositories selected to run Actions in organization {org}.
        slots:
          org: path.org
      - text: Show page {page} of Actions-enabled selected repos in {org}.
        slots:
          page: query.page
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/repositories'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the repos enabled for Actions in an org
      effect: write
      questions:
      - Can I replace the whole list of repositories allowed to run Actions in my org at once?
      - What happens to repos left out when I reset the org's Actions-enabled repository list?
      instructions:
      - text: Replace the Actions-enabled repositories in organization {org} with {selected_repository_ids}.
        slots:
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
      - text: Make only repository IDs {selected_repository_ids} able to run Actions in {org}.
        slots:
          selected_repository_ids: requestBody.selected_repository_ids
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/repositories/{repository_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable Actions for one repo in an org
      effect: write
      questions:
      - How do I let one more repository in my org start running GitHub Actions?
      - Can I add a single repo to my org's selected Actions repositories without touching the rest?
      instructions:
      - text: Enable Actions for repository {repository_id} in organization {org}.
        slots:
          repository_id: path.repository_id
          org: path.org
      - text: Add repo {repository_id} to the Actions-enabled list in {org}.
        slots:
          repository_id: path.repository_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/repositories/{repository_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable Actions for one repo in an org
      effect: destructive
      questions:
      - How do I stop one repository in my org from running GitHub Actions?
      - Can I pull a single repo out of my org's Actions-enabled list?
      instructions:
      - text: Disable Actions for repository {repository_id} in organization {org}.
        slots:
          repository_id: path.repository_id
          org: path.org
      - text: Remove repo {repository_id} from the Actions-enabled repositories in {org}.
        slots:
          repository_id: path.repository_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/selected-actions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the allowed actions list for an org
      effect: read
      questions:
      - Which actions and reusable workflows are allowed to run in my organization?
      - Does my org allow GitHub-owned actions, and what name patterns are permitted?
      instructions:
      - text: Show the allowed actions settings for organization {org}.
        slots:
          org: path.org
      - text: List the action patterns permitted in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/selected-actions'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the allowed actions list for an org
      effect: write
      questions:
      - Can I allow only GitHub-owned actions plus a few named patterns in my org?
      - How do I allowlist specific third-party actions for my whole organization?
      instructions:
      - text: Allow actions matching {patterns_allowed} in organization {org}.
        slots:
          patterns_allowed: requestBody.patterns_allowed
          org: path.org
      - text: Set GitHub-owned actions allowed to {github_owned_allowed} and patterns to {patterns_allowed} for {org}.
        slots:
          github_owned_allowed: requestBody.github_owned_allowed
          patterns_allowed: requestBody.patterns_allowed
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/workflow'].get
  update:
    x-apievangelist-phrasing:
      intent: Get default GITHUB_TOKEN permissions for an org
      effect: read
      questions:
      - What access does GITHUB_TOKEN have by default in my organization's workflows?
      - Can workflows in my org approve pull requests right now?
      instructions:
      - text: Show default workflow token permissions for organization {org}.
        slots:
          org: path.org
      - text: Check whether Actions may approve pull request reviews in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/permissions/workflow'].put
  update:
    x-apievangelist-phrasing:
      intent: Set default GITHUB_TOKEN permissions for an org
      effect: write
      questions:
      - How can I make workflow tokens read-only by default across my organization?
      - Can I let Actions approve pull requests in my org?
      instructions:
      - text: Set default workflow token permissions in organization {org} to {default_workflow_permissions}.
        slots:
          org: path.org
          default_workflow_permissions: requestBody.default_workflow_permissions
      - text: Set pull request approval by Actions in {org} to {can_approve_pull_request_reviews}.
        slots:
          org: path.org
          can_approve_pull_request_reviews: requestBody.can_approve_pull_request_reviews
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List self-hosted runner groups in an org
      effect: read
      questions:
      - Which self-hosted runner groups exist in my organization, including enterprise ones?
      - Can I see only the runner groups a particular repository is allowed to use?
      instructions:
      - text: List self-hosted runner groups in organization {org}.
        slots:
          org: path.org
      - text: Show runner groups in {org} visible to repository {visible_to_repository}.
        slots:
          org: path.org
          visible_to_repository: query.visible_to_repository
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a self-hosted runner group in an org
      effect: write
      questions:
      - How do I create a new group to organize self-hosted runners in my organization?
      - Can a new runner group be limited to selected repositories or specific workflows?
      instructions:
      - text: Create a runner group named {name} in organization {org}.
        slots:
          name: requestBody.name
          org: path.org
      - text: Create runner group {name} in {org} with {visibility} visibility for repositories {selected_repository_ids}.
        slots:
          name: requestBody.name
          org: path.org
          visibility: requestBody.visibility
          selected_repository_ids: requestBody.selected_repository_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a self-hosted runner group in an org
      effect: read
      questions:
      - What are the settings of a specific runner group in my org?
      - Is one of my org's runner groups restricted to certain workflows?
      instructions:
      - text: Get runner group {runner_group_id} in organization {org}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Show the visibility and workflow restrictions of runner group {runner_group_id} in {org}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a self-hosted runner group from an org
      effect: destructive
      questions:
      - How do I delete a runner group my organization no longer needs?
      - Can I remove an entire self-hosted runner group from my org?
      instructions:
      - text: Delete runner group {runner_group_id} from organization {org}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Remove the self-hosted runner group {runner_group_id} in {org}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a self-hosted runner group in an org
      effect: write
      questions:
      - Can I rename a runner group or change who can see it in my org?
      - How do I let an existing runner group be used by public repositories?
      instructions:
      - text: Rename runner group {runner_group_id} in organization {org} to {name}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
          name: requestBody.name
      - text: Set runner group {runner_group_id} in {org} to name {name} with {visibility} visibility.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
          name: requestBody.name
          visibility: requestBody.visibility
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List repos that can use an org runner group
      effect: read
      questions:
      - Which repositories are allowed to use a given runner group in my org?
      - What repos currently have access to one of my organization's runner groups?
      instructions:
      - text: List repositories with access to runner group {runner_group_id} in organization {org}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Show page {page} of repos that can use runner group {runner_group_id} in {org}.
        slots:
          page: query.page
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the repos that can use an org runner group
      effect: write
      questions:
      - Can I overwrite the full list of repos allowed to use a runner group in one call?
      - What does resetting a runner group's repository access to a new list look like?
      instructions:
      - text: Replace the repos with access to runner group {runner_group_id} in {org} with {selected_repository_ids}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
      - text: Give only repositories {selected_repository_ids} access to runner group {runner_group_id} in {org}.
        slots:
          selected_repository_ids: requestBody.selected_repository_ids
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Grant one repo access to an org runner group
      effect: write
      questions:
      - How do I let one more repository use a runner group with selected visibility?
      - Can I add a single repo to a runner group's access list?
      instructions:
      - text: Grant repository {repository_id} access to runner group {runner_group_id} in organization {org}.
        slots:
          repository_id: path.repository_id
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Add repo {repository_id} to runner group {runner_group_id} in {org}.
        slots:
          repository_id: path.repository_id
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke one repo's access to an org runner group
      effect: destructive
      questions:
      - How do I stop a repository from using one of my org's runner groups?
      - Can I take a single repo out of a runner group's access list?
      instructions:
      - text: Revoke repository {repository_id} access to runner group {runner_group_id} in organization {org}.
        slots:
          repository_id: path.repository_id
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Remove repo {repository_id} from runner group {runner_group_id} access in {org}.
        slots:
          repository_id: path.repository_id
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/runners'].get
  update:
    x-apievangelist-phrasing:
      intent: List the runners in an org runner group
      effect: read
      questions:
      - Which self-hosted runners belong to a particular group in my org?
      - What machines are assigned to one of my organization's runner groups?
      instructions:
      - text: List the runners in runner group {runner_group_id} in organization {org}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Show page {page} of runners assigned to group {runner_group_id} in {org}.
        slots:
          page: query.page
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/runners'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the runners in an org runner group
      effect: write
      questions:
      - Can I replace every runner in a group with a new set in one step?
      - How do I redefine exactly which runners make up an org runner group?
      instructions:
      - text: Replace the runners in group {runner_group_id} in {org} with {runners}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
          runners: requestBody.runners
      - text: Make runner group {runner_group_id} in organization {org} contain only runners {runners}.
        slots:
          runner_group_id: path.runner_group_id
          org: path.org
          runners: requestBody.runners
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a runner to an org runner group
      effect: write
      questions:
      - How do I move a self-hosted runner into a specific runner group in my org?
      - Can I assign one runner to a runner group without changing the others?
      instructions:
      - text: Add runner {runner_id} to runner group {runner_group_id} in organization {org}.
        slots:
          runner_id: path.runner_id
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Put self-hosted runner {runner_id} into group {runner_group_id} in {org}.
        slots:
          runner_id: path.runner_id
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a runner from an org runner group
      effect: destructive
      questions:
      - What happens to a runner when I take it out of an org runner group?
      - Can I send a runner back to the default group in my organization?
      instructions:
      - text: Remove runner {runner_id} from runner group {runner_group_id} in organization {org}.
        slots:
          runner_id: path.runner_id
          runner_group_id: path.runner_group_id
          org: path.org
      - text: Move runner {runner_id} out of group {runner_group_id} in {org} back to the default group.
        slots:
          runner_id: path.runner_id
          runner_group_id: path.runner_group_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners'].get
  update:
    x-apievangelist-phrasing:
      intent: List self-hosted runners in an org
      effect: read
      questions:
      - Which self-hosted runners are registered to my organization?
      - Can I see every org-level runner along with its status?
      instructions:
      - text: List all self-hosted runners in organization {org}.
        slots:
          org: path.org
      - text: Show page {page} of self-hosted runners for {org}.
        slots:
          page: query.page
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/downloads'].get
  update:
    x-apievangelist-phrasing:
      intent: List runner app downloads for an org
      effect: read
      questions:
      - Where do I download the runner application binaries to set up an org runner?
      - Which operating systems and architectures is the runner application offered for?
      instructions:
      - text: List runner application downloads for organization {org}.
        slots:
          org: path.org
      - text: Get the runner binaries I can install for {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/registration-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a token to register an org runner
      effect: write
      questions:
      - How do I get a token to register a new self-hosted runner with my organization?
      - How long does an org runner registration token stay valid?
      instructions:
      - text: Create a runner registration token for organization {org}.
        slots:
          org: path.org
      - text: Generate a token so I can configure a new self-hosted runner in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/remove-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a token to remove an org runner
      effect: write
      questions:
      - What token do I need to unregister a self-hosted runner from my organization with the config script?
      - Can I generate a one-hour token for removing an org runner?
      instructions:
      - text: Create a runner remove token for organization {org}.
        slots:
          org: path.org
      - text: Generate a token to unregister a self-hosted runner from {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a self-hosted runner in an org
      effect: read
      questions:
      - Is a specific self-hosted runner in my org online and busy?
      - What details does GitHub hold for one of my organization's runners?
      instructions:
      - text: Get self-hosted runner {runner_id} in organization {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      - text: Show the status of runner {runner_id} registered to {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Force-remove a self-hosted runner from an org
      effect: destructive
      questions:
      - How do I remove a runner from my org when its machine no longer exists?
      - Can I force-delete an organization runner without running the config script?
      instructions:
      - text: Delete self-hosted runner {runner_id} from organization {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      - text: Force-remove runner {runner_id} from {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List labels on an org runner
      effect: read
      questions:
      - Which labels are attached to one of my organization's self-hosted runners?
      - What labels can workflows target on a given org runner?
      instructions:
      - text: List labels on self-hosted runner {runner_id} in organization {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      - text: Show all labels for runner {runner_id} in {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}/labels'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace custom labels on an org runner
      effect: write
      questions:
      - Can I wipe an org runner's custom labels and set a fresh list in one call?
      - How do I overwrite all custom labels on a runner in my organization?
      instructions:
      - text: Replace the custom labels on runner {runner_id} in organization {org} with {labels}.
        slots:
          runner_id: path.runner_id
          org: path.org
          labels: requestBody.labels
      - text: Set runner {runner_id} in {org} to have exactly the custom labels {labels}.
        slots:
          runner_id: path.runner_id
          org: path.org
          labels: requestBody.labels
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Add custom labels to an org runner
      effect: write
      questions:
      - How do I tag an org self-hosted runner with extra labels like gpu?
      - Can I append custom labels to a runner without losing the ones it already has?
      instructions:
      - text: Add labels {labels} to self-hosted runner {runner_id} in organization {org}.
        slots:
          labels: requestBody.labels
          runner_id: path.runner_id
          org: path.org
      - text: Tag runner {runner_id} in {org} with {labels}.
        slots:
          runner_id: path.runner_id
          org: path.org
          labels: requestBody.labels
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}/labels'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear all custom labels from an org runner
      effect: destructive
      questions:
      - How do I strip every custom label from an org runner and keep only the built-in ones?
      - Which labels remain after clearing custom labels from a runner?
      instructions:
      - text: Remove all custom labels from runner {runner_id} in organization {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      - text: Clear custom labels on self-hosted runner {runner_id} in {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}/labels/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove one custom label from an org runner
      effect: destructive
      questions:
      - Can I delete just one custom label from an org runner?
      - What happens if I try to remove a label an org runner doesn't have?
      instructions:
      - text: Remove the label {name} from runner {runner_id} in organization {org}.
        slots:
          name: path.name
          runner_id: path.runner_id
          org: path.org
      - text: Untag runner {runner_id} in {org} from label {name}.
        slots:
          runner_id: path.runner_id
          org: path.org
          name: path.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List Actions secrets in an org
      effect: read
      questions:
      - Which Actions secrets are defined at my organization level?
      - Can I see my org's secret names without exposing their values?
      instructions:
      - text: List Actions secrets in organization {org}.
        slots:
          org: path.org
      - text: Show page {page} of org secrets for {org}.
        slots:
          page: query.page
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/public-key'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the org public key for encrypting secrets
      effect: read
      questions:
      - Which public key do I need to encrypt an organization Actions secret before saving it?
      - Where do I get the key_id to send with a new org secret?
      instructions:
      - text: Get the Actions secrets public key for organization {org}.
        slots:
          org: path.org
      - text: Fetch the encryption key for creating secrets in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/{secret_name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an org Actions secret's metadata
      effect: read
      questions:
      - When was an organization secret last updated and who can see it?
      - What visibility does a specific org secret have?
      instructions:
      - text: Get organization secret {secret_name} in {org}.
        slots:
          secret_name: path.secret_name
          org: path.org
      - text: Show the visibility and update time of secret {secret_name} in organization {org}.
        slots:
          secret_name: path.secret_name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/{secret_name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an org Actions secret
      effect: write
      questions:
      - How do I add an encrypted secret that all repos in my organization can use?
      - Can I share an org secret with only private repositories?
      instructions:
      - text: Save org secret {secret_name} in {org} with encrypted value {encrypted_value} and {visibility} visibility.
        slots:
          secret_name: path.secret_name
          org: path.org
          encrypted_value: requestBody.encrypted_value
          visibility: requestBody.visibility
      - text: Create secret {secret_name} in organization {org} visible to repositories {selected_repository_ids}.
        slots:
          secret_name: path.secret_name
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/{secret_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an org Actions secret
      effect: destructive
      questions:
      - How do I delete an Actions secret from my organization?
      - Can I remove an org-level secret that repositories no longer need?
      instructions:
      - text: Delete organization secret {secret_name} from {org}.
        slots:
          secret_name: path.secret_name
          org: path.org
      - text: Remove the {secret_name} Actions secret in organization {org}.
        slots:
          secret_name: path.secret_name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/{secret_name}/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List repos that can use an org secret
      effect: read
      questions:
      - Which repositories can read an organization secret shared with selected repos?
      - What repos is my org secret currently exposed to?
      instructions:
      - text: List repositories that can use org secret {secret_name} in {org}.
        slots:
          secret_name: path.secret_name
          org: path.org
      - text: Show page {page} of repos selected for secret {secret_name} in organization {org}.
        slots:
          page: query.page
          secret_name: path.secret_name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/{secret_name}/repositories'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the repos that can use an org secret
      effect: write
      questions:
      - Can I reset the entire list of repos that get an organization secret?
      - How do I overwrite which selected repositories an org secret is shared with?
      instructions:
      - text: Replace the repos for org secret {secret_name} in {org} with {selected_repository_ids}.
        slots:
          secret_name: path.secret_name
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
      - text: Share secret {secret_name} in organization {org} with only repositories {selected_repository_ids}.
        slots:
          secret_name: path.secret_name
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Share an org secret with one more repo
      effect: write
      questions:
      - How do I give one additional repository access to an org secret?
      - Can I add a repo to an org secret without redoing the whole list?
      instructions:
      - text: Add repository {repository_id} to org secret {secret_name} in {org}.
        slots:
          repository_id: path.repository_id
          secret_name: path.secret_name
          org: path.org
      - text: Share secret {secret_name} in organization {org} with repo {repository_id}.
        slots:
          secret_name: path.secret_name
          org: path.org
          repository_id: path.repository_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unshare an org secret from one repo
      effect: destructive
      questions:
      - How do I stop one repository from reading an organization secret?
      - Can I revoke a single repo's access to an org secret?
      instructions:
      - text: Remove repository {repository_id} from org secret {secret_name} in {org}.
        slots:
          repository_id: path.repository_id
          secret_name: path.secret_name
          org: path.org
      - text: Revoke repo {repository_id}'s access to secret {secret_name} in organization {org}.
        slots:
          repository_id: path.repository_id
          secret_name: path.secret_name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List Actions variables in an org
      effect: read
      questions:
      - Which configuration variables are defined for Actions at my organization level?
      - Can I see the values of all my org's Actions variables?
      instructions:
      - text: List Actions variables in organization {org}.
        slots:
          org: path.org
      - text: Show page {page} of org variables for {org}.
        slots:
          page: query.page
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an org Actions variable
      effect: write
      questions:
      - How do I add a plain-text configuration variable that workflows across my org can read?
      - Can an org variable be limited to selected repositories?
      instructions:
      - text: Create org variable {name} in {org} with value {value} and {visibility} visibility.
        slots:
          name: requestBody.name
          org: path.org
          value: requestBody.value
          visibility: requestBody.visibility
      - text: Add variable {name}={value} to organization {org} for repositories {selected_repository_ids}, visibility {visibility}.
        slots:
          name: requestBody.name
          value: requestBody.value
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
          visibility: requestBody.visibility
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an org Actions variable
      effect: read
      questions:
      - What value is an organization Actions variable currently set to?
      - Which repositories can see a specific org variable?
      instructions:
      - text: Get organization variable {name} in {org}.
        slots:
          name: path.name
          org: path.org
      - text: Show the value and visibility of variable {name} in organization {org}.
        slots:
          name: path.name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an org Actions variable
      effect: destructive
      questions:
      - How do I delete a configuration variable from my organization?
      - Can I remove an org-level Actions variable by name?
      instructions:
      - text: Delete organization variable {name} from {org}.
        slots:
          name: path.name
          org: path.org
      - text: Remove the {name} Actions variable in organization {org}.
        slots:
          name: path.name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an org Actions variable
      effect: write
      questions:
      - Can I change the value of an existing organization variable?
      - How do I rename an org variable or change which repos see it?
      instructions:
      - text: Update org variable {name} in {org} to value {value}.
        slots:
          name: path.name
          org: path.org
          value: requestBody.value
      - text: Rename organization variable {name} in {org} to {new_name}.
        slots:
          name: path.name
          org: path.org
          new_name: requestBody.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables/{name}/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List repos that can use an org variable
      effect: read
      questions:
      - Which repositories can read an org variable that's shared with selected repos?
      - What repos currently have access to one of my organization's variables?
      instructions:
      - text: List repositories that can use org variable {name} in {org}.
        slots:
          name: path.name
          org: path.org
      - text: Show page {page} of repos selected for variable {name} in organization {org}.
        slots:
          page: query.page
          name: path.name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables/{name}/repositories'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the repos that can use an org variable
      effect: write
      questions:
      - Can I overwrite the full list of repositories that see an org variable?
      - How do I reset which selected repos an organization variable is shared with?
      instructions:
      - text: Replace the repos for org variable {name} in {org} with {selected_repository_ids}.
        slots:
          name: path.name
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
      - text: Share variable {name} in organization {org} with only repositories {selected_repository_ids}.
        slots:
          name: path.name
          org: path.org
          selected_repository_ids: requestBody.selected_repository_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables/{name}/repositories/{repository_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Share an org variable with one more repo
      effect: write
      questions:
      - How do I let one more repository read an organization variable?
      - Can I add a single repo to an org variable's selected list?
      instructions:
      - text: Add repository {repository_id} to org variable {name} in {org}.
        slots:
          repository_id: path.repository_id
          name: path.name
          org: path.org
      - text: Share variable {name} in organization {org} with repo {repository_id}.
        slots:
          name: path.name
          org: path.org
          repository_id: path.repository_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/actions/variables/{name}/repositories/{repository_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unshare an org variable from one repo
      effect: destructive
      questions:
      - How do I stop one repo from seeing an organization variable?
      - Can I revoke a single repository's access to an org variable?
      instructions:
      - text: Remove repository {repository_id} from org variable {name} in {org}.
        slots:
          repository_id: path.repository_id
          name: path.name
          org: path.org
      - text: Revoke repo {repository_id}'s access to variable {name} in organization {org}.
        slots:
          repository_id: path.repository_id
          name: path.name
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List workflow artifacts in a repository
      effect: read
      questions:
      - What build artifacts have my workflows uploaded across a repository?
      - Can I find all artifacts in a repo with a particular name?
      instructions:
      - text: List workflow artifacts in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Find artifacts named {name} across all runs in {owner}/{repo}.
        slots:
          name: query.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow artifact
      effect: read
      questions:
      - How big is a specific workflow artifact and when does it expire?
      - Has a particular build artifact already expired?
      instructions:
      - text: Get artifact {artifact_id} in {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Show the size and expiry of artifact {artifact_id} from {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workflow artifact
      effect: destructive
      questions:
      - How do I delete a build artifact to free up Actions storage?
      - Can I remove one specific artifact from a workflow run?
      instructions:
      - text: Delete artifact {artifact_id} from {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Remove workflow artifact {artifact_id} in {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a workflow artifact archive
      effect: read
      questions:
      - How do I download the zip of an artifact my workflow produced?
      - How long is the artifact download link valid for?
      instructions:
      - text: Download artifact {artifact_id} from {owner}/{repo} as {archive_format}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
          archive_format: path.archive_format
      - text: Get the {archive_format} download link for artifact {artifact_id} in {owner}/{repo}.
        slots:
          archive_format: path.archive_format
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/cache/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Check Actions cache usage for a repository
      effect: read
      questions:
      - How much Actions cache is a single repository using?
      - What's the active cache count and size for one of my repos?
      instructions:
      - text: Show Actions cache usage for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Tell me how many caches {owner}/{repo} has and their total size.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/cache/usage-policy'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's Actions cache size limit
      effect: read
      questions:
      - What Actions cache size limit applies to my repository?
      - Is my repo's cache limit higher than the default?
      instructions:
      - text: Look up the cache size policy set on repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the cache size limit in GB configured for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/cache/usage-policy'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set a repository's Actions cache size limit
      effect: write
      questions:
      - Can I give one repository more Actions cache space than the default?
      - How do I change the cache size limit for a single repo?
      instructions:
      - text: Set the Actions cache limit for {owner}/{repo} to {repo_cache_size_limit_in_gb} GB.
        slots:
          owner: path.owner
          repo: path.repo
          repo_cache_size_limit_in_gb: requestBody.repo_cache_size_limit_in_gb
      - text: Change {owner}/{repo}'s cache size limit to {repo_cache_size_limit_in_gb} GB.
        slots:
          owner: path.owner
          repo: path.repo
          repo_cache_size_limit_in_gb: requestBody.repo_cache_size_limit_in_gb
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/caches'].get
  update:
    x-apievangelist-phrasing:
      intent: List Actions caches in a repository
      effect: read
      questions:
      - Which Actions caches exist in my repo, and which were used most recently?
      - Can I filter a repository's caches by branch ref or key prefix?
      instructions:
      - text: List Actions caches in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show caches in {owner}/{repo} for ref {ref} whose key starts with {key}, sorted by {sort}.
        slots:
          owner: path.owner
          repo: path.repo
          ref: query.ref
          key: query.key
          sort: query.sort
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/caches'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete Actions caches by key
      effect: destructive
      questions:
      - How do I delete every cache that matches a given cache key?
      - Can I clear caches for one key on a single branch only?
      instructions:
      - text: Delete Actions caches with key {key} in {owner}/{repo}.
        slots:
          key: query.key
          owner: path.owner
          repo: path.repo
      - text: Clear caches with key {key} on ref {ref} in {owner}/{repo}.
        slots:
          key: query.key
          ref: query.ref
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/caches/{cache_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one Actions cache by ID
      effect: destructive
      questions:
      - Can I delete a single Actions cache entry using its ID?
      - What's the way to remove one specific cache when I know its cache ID?
      instructions:
      - text: Delete Actions cache {cache_id} from {owner}/{repo}.
        slots:
          cache_id: path.cache_id
          owner: path.owner
          repo: path.repo
      - text: Remove the cache with ID {cache_id} in {owner}/{repo}.
        slots:
          cache_id: path.cache_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs/{job_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a job from a workflow run
      effect: read
      questions:
      - Which step did a specific job fail on, and how long did it take?
      - What runner did a particular Actions job execute on?
      instructions:
      - text: Get job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      - text: Show the steps and status 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-24'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs/{job_id}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Download logs for a single job
      effect: read
      questions:
      - How do I get the plain-text log for one job instead of the whole run?
      - Where can I download the output of a single failing Actions job?
      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: Get the plain-text log link for workflow job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs/{job_id}/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-run one job and its dependents
      effect: write
      questions:
      - Can I re-run just one job from a workflow run instead of the entire workflow?
      - How do I retry a single job with debug logging turned on?
      instructions:
      - text: Re-run job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      - text: Re-run job {job_id} in {owner}/{repo} with debug logging set to {enable_debug_logging}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
          enable_debug_logging: requestBody.enable_debug_logging
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/oidc/customization/sub'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repo's OIDC subject claim template
      effect: read
      questions:
      - What claim keys make up my repository's OIDC token subject?
      - Is my repo using the default OIDC subject claim or a custom one?
      instructions:
      - text: Get the OIDC subject claim template for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show whether {owner}/{repo} uses a custom OIDC sub claim.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/oidc/customization/sub'].put
  update:
    x-apievangelist-phrasing:
      intent: Customize a repo's OIDC subject claim
      effect: write
      questions:
      - How do I change which claims appear in the OIDC subject for my repo's workflows?
      - Can I opt a repository back into the default OIDC subject format?
      instructions:
      - text: Set the OIDC subject claim for {owner}/{repo} to use default {use_default}.
        slots:
          owner: path.owner
          repo: path.repo
          use_default: requestBody.use_default
      - text: Customize the OIDC sub claim in {owner}/{repo} to include keys {include_claim_keys}, use default {use_default}.
        slots:
          owner: path.owner
          repo: path.repo
          include_claim_keys: requestBody.include_claim_keys
          use_default: requestBody.use_default
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/organization-secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List org secrets shared with a repo
      effect: read
      questions:
      - Which organization-level secrets can my repository's workflows use?
      - What org secrets has my org shared into this repo?
      instructions:
      - text: List organization secrets shared with {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show which org-level secrets {owner}/{repo} inherits.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/organization-variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List org variables shared with a repo
      effect: read
      questions:
      - Which organization variables are available to my repository?
      - What org-level configuration variables does this repo inherit?
      instructions:
      - text: List organization variables shared with {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the org-level variables {owner}/{repo} can read.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Actions permissions for a repository
      effect: read
      questions:
      - Is GitHub Actions turned on for my repository, and which actions may run?
      - Does this repo allow all actions or only selected ones?
      instructions:
      - text: Check if repository {owner}/{repo} has Actions enabled and which actions it allows.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Check whether Actions is enabled in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or restrict Actions for a repository
      effect: write
      questions:
      - How do I turn GitHub Actions off entirely for one repository?
      - Can I limit a repo to local actions only?
      instructions:
      - text: Set Actions enabled to {enabled} for {owner}/{repo}.
        slots:
          enabled: requestBody.enabled
          owner: path.owner
          repo: path.repo
      - text: Enable Actions in {owner}/{repo} and allow {allowed_actions} actions, enabled {enabled}.
        slots:
          owner: path.owner
          repo: path.repo
          allowed_actions: requestBody.allowed_actions
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions/access'].get
  update:
    x-apievangelist-phrasing:
      intent: Get outside workflow access to a private repo
      effect: read
      questions:
      - Can workflows in other repositories use the actions stored in my private repo?
      - What access level do outside workflows have to this repo's reusable workflows?
      instructions:
      - text: Get the access level other workflows have to {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show whether workflows outside {owner}/{repo} can use its actions.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions/access'].put
  update:
    x-apievangelist-phrasing:
      intent: Share a private repo's actions with other repos
      effect: write
      questions:
      - How do I let other repos in my organization use actions from my private repository?
      - Can I share a repo's reusable workflows with the whole enterprise?
      instructions:
      - text: Set outside workflow access to {owner}/{repo} to {access_level}.
        slots:
          owner: path.owner
          repo: path.repo
          access_level: requestBody.access_level
      - text: Share the actions in {owner}/{repo} at the {access_level} access level.
        slots:
          owner: path.owner
          repo: path.repo
          access_level: requestBody.access_level
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions/selected-actions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the allowed actions list for a repository
      effect: read
      questions:
      - Which actions patterns are allowlisted in my repository?
      - Does this repo permit GitHub-owned actions?
      instructions:
      - text: Show which actions repository {owner}/{repo} has allowlisted.
        slots:
          owner: path.owner
          repo: path.repo
      - text: List the action patterns permitted to run in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions/selected-actions'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the allowed actions list for a repository
      effect: write
      questions:
      - How do I allowlist a few specific actions for just one repository?
      - Can I block GitHub-owned actions in a single repo?
      instructions:
      - text: Allow actions matching {patterns_allowed} in {owner}/{repo}.
        slots:
          patterns_allowed: requestBody.patterns_allowed
          owner: path.owner
          repo: path.repo
      - text: Set GitHub-owned actions allowed to {github_owned_allowed} and patterns to {patterns_allowed} in {owner}/{repo}.
        slots:
          github_owned_allowed: requestBody.github_owned_allowed
          patterns_allowed: requestBody.patterns_allowed
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions/workflow'].get
  update:
    x-apievangelist-phrasing:
      intent: Get default GITHUB_TOKEN permissions for a repo
      effect: read
      questions:
      - What does GITHUB_TOKEN get by default in my repository's workflows?
      - Can workflows in this particular repo approve pull requests?
      instructions:
      - text: Show what the GITHUB_TOKEN can do by default in repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Check whether Actions may approve pull requests in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/permissions/workflow'].put
  update:
    x-apievangelist-phrasing:
      intent: Set default GITHUB_TOKEN permissions for a repo
      effect: write
      questions:
      - How can I give GITHUB_TOKEN write access by default in a single repo?
      - Can I allow Actions to approve pull requests in one repository only?
      instructions:
      - text: Give the GITHUB_TOKEN in repository {owner}/{repo} {default_workflow_permissions} access by default.
        slots:
          owner: path.owner
          repo: path.repo
          default_workflow_permissions: requestBody.default_workflow_permissions
      - text: Update repository {owner}/{repo} so Actions pull request approval is {can_approve_pull_request_reviews}.
        slots:
          owner: path.owner
          repo: path.repo
          can_approve_pull_request_reviews: requestBody.can_approve_pull_request_reviews
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners'].get
  update:
    x-apievangelist-phrasing:
      intent: List self-hosted runners in a repository
      effect: read
      questions:
      - Which self-hosted runners are registered directly to my repository?
      - Are any repo-level runners offline right now?
      instructions:
      - text: List self-hosted runners in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show page {page} of repo runners for {owner}/{repo}.
        slots:
          page: query.page
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/downloads'].get
  update:
    x-apievangelist-phrasing:
      intent: List runner app downloads for a repository
      effect: read
      questions:
      - Where can I download the runner software to add a runner to one repo?
      - What runner binaries are available for setting up a repository runner?
      instructions:
      - text: List runner application downloads for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Fetch download links for the runner software for repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/registration-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a token to register a repo runner
      effect: write
      questions:
      - How do I get a token to register a self-hosted runner to a single repository?
      - Does a repository runner registration token expire?
      instructions:
      - text: Issue a one-hour registration token for adding a runner to repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Generate a token to configure a new self-hosted runner in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/remove-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a token to remove a repo runner
      effect: write
      questions:
      - What token does the config script need to unregister a runner from my repo?
      - Can I generate a token for removing a repository runner cleanly?
      instructions:
      - text: Issue a one-hour remove token for a runner in repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Get a token the config script can use to deregister a runner from repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a self-hosted runner in a repository
      effect: read
      questions:
      - Is a specific repository runner online and currently running a job?
      - What operating system is one of my repo's runners on?
      instructions:
      - text: Get self-hosted runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Show the status of repo runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Force-remove a self-hosted runner from a repo
      effect: destructive
      questions:
      - How do I remove a repository runner whose machine is gone?
      - Can I force-delete a runner registered to a single repo?
      instructions:
      - text: Delete self-hosted runner {runner_id} from {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Force-remove runner {runner_id} from repository {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List labels on a repo runner
      effect: read
      questions:
      - Which labels does one of my repository's runners carry?
      - What labels can my repo's workflows use to target a specific runner?
      instructions:
      - text: List labels on runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Show the labels repository runner {runner_id} in {owner}/{repo} carries.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}/labels'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace custom labels on a repo runner
      effect: write
      questions:
      - Can I replace all custom labels on a repository runner with a new set?
      - How do I overwrite a repo runner's labels in one call?
      instructions:
      - text: Replace custom labels on runner {runner_id} in {owner}/{repo} with {labels}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          labels: requestBody.labels
      - text: Set repo runner {runner_id} in {owner}/{repo} to exactly the labels {labels}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          labels: requestBody.labels
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Add custom labels to a repo runner
      effect: write
      questions:
      - How do I add an extra label to a runner registered to my repository?
      - Can I append labels to a repo runner without removing existing ones?
      instructions:
      - text: Add labels {labels} to runner {runner_id} in {owner}/{repo}.
        slots:
          labels: requestBody.labels
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Tag repo runner {runner_id} in {owner}/{repo} with {labels}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          labels: requestBody.labels
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}/labels'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear all custom labels from a repo runner
      effect: destructive
      questions:
      - How do I reset a repository runner to only its built-in labels?
      - Can I strip every custom label from a runner in my repo at once?
      instructions:
      - text: Strip every custom label off repository runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Clear the custom labels on repo runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove one custom label from a repo runner
      effect: destructive
      questions:
      - Can I take a single custom label off a repository runner?
      - What labels are left after I remove one from a repo runner?
      instructions:
      - text: Remove label {name} from runner {runner_id} in {owner}/{repo}.
        slots:
          name: path.name
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Untag repo runner {runner_id} in {owner}/{repo} from label {name}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          name: path.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List workflow runs across a repository
      effect: read
      questions:
      - Which workflow runs failed in my repository this week, across all workflows?
      - Can I filter a repo's workflow runs by branch, actor or triggering event?
      - What runs were kicked off for a specific commit SHA?
      instructions:
      - text: List all 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 every workflow run in {owner}/{repo} for commit {head_sha}.
        slots:
          owner: path.owner
          repo: path.repo
          head_sha: query.head_sha
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow run
      effect: read
      questions:
      - What's the status and conclusion of a specific workflow run?
      - Which commit and branch triggered a particular run?
      instructions:
      - text: Get workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Show the conclusion of run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workflow run
      effect: destructive
      questions:
      - How do I delete an old workflow run from my repository's history?
      - Can I remove a single run from the Actions tab?
      instructions:
      - text: Delete workflow run {run_id} from {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Remove run {run_id} in {owner}/{repo} from the run history.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/approvals'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the approval history for a workflow run
      effect: read
      questions:
      - Who approved or rejected the deployment gates on a workflow run?
      - Can I see the review comments left on a run's environment approvals?
      instructions:
      - text: Show the review history for workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: List who approved deployments for run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifacts from a workflow run
      effect: read
      questions:
      - Which artifacts did one particular workflow run upload?
      - Can I find an artifact by name within a single run?
      instructions:
      - text: List the artifacts from run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Find artifact {name} produced by run {run_id} in {owner}/{repo}.
        slots:
          name: query.name
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a specific attempt of a workflow run
      effect: read
      questions:
      - How did the second attempt of a re-run workflow turn out?
      - Can I look at one specific retry of a workflow run?
      instructions:
      - text: Get attempt {attempt_number} of run {run_id} in {owner}/{repo}.
        slots:
          attempt_number: path.attempt_number
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Show the result of workflow run {run_id} attempt {attempt_number} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          attempt_number: path.attempt_number
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List jobs in a workflow run attempt
      effect: read
      questions:
      - Which jobs ran during one specific attempt of a workflow run?
      - Can I see job results for an earlier retry, not the latest one?
      instructions:
      - text: List jobs for attempt {attempt_number} of run {run_id} in {owner}/{repo}.
        slots:
          attempt_number: path.attempt_number
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Show page {page} of jobs in run {run_id} attempt {attempt_number} for {owner}/{repo}.
        slots:
          page: query.page
          run_id: path.run_id
          attempt_number: path.attempt_number
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Download logs for a workflow run attempt
      effect: read
      questions:
      - How do I download the logs from a previous attempt of a workflow run?
      - Can I get the log archive for a single retry of a run?
      instructions:
      - text: Download logs for attempt {attempt_number} of run {run_id} in {owner}/{repo}.
        slots:
          attempt_number: path.attempt_number
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Get the log archive link for run {run_id} attempt {attempt_number} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          attempt_number: path.attempt_number
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a workflow run
      effect: destructive
      questions:
      - How do I stop a workflow run that is stuck or no longer needed?
      - Can I cancel an in-progress Actions run from the API?
      instructions:
      - text: Cancel workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Stop the in-progress run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List jobs in a workflow run
      effect: read
      questions:
      - Which jobs in my latest workflow run failed?
      - Can I list jobs from every attempt of a run, not just the most recent?
      instructions:
      - text: List the jobs in workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Show jobs for run {run_id} in {owner}/{repo} using filter {filter}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
          filter: query.filter
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Download all logs for a workflow run
      effect: read
      questions:
      - How do I download the full log archive for a workflow run?
      - Is the run log download URL time-limited?
      instructions:
      - text: Download the logs for workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Fetch the zipped logs of every job in workflow run {run_id} of {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/logs'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete all logs for a workflow run
      effect: destructive
      questions:
      - Can I wipe the logs of a run that accidentally printed a secret?
      - How do I delete a workflow run's logs but keep the run itself?
      instructions:
      - text: Delete all logs for workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Purge the logs of run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployments waiting on approval for a run
      effect: read
      questions:
      - Which environments is my workflow run waiting on approval for?
      - Can I see the pending deployment gates holding up a run?
      instructions:
      - text: Show pending deployments for workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: List environments awaiting approval in run {run_id} of {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject pending deployments for a run
      effect: write
      questions:
      - How do I approve a deployment that's waiting on me as a required reviewer?
      - Can I reject a pending production deployment with a comment?
      instructions:
      - text: Mark pending deployments to environments {environment_ids} in run {run_id} of {owner}/{repo} as {state} with comment {comment}.
        slots:
          environment_ids: requestBody.environment_ids
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
          state: requestBody.state
          comment: requestBody.comment
      - text: Approve environments {environment_ids} for run {run_id} in {owner}/{repo}, set state {state}, and note {comment}.
        slots:
          environment_ids: requestBody.environment_ids
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
          state: requestBody.state
          comment: requestBody.comment
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-run an entire workflow run
      effect: write
      questions:
      - How do I re-run a whole workflow run from the start?
      - Can I re-run a workflow with debug logging enabled?
      instructions:
      - text: Re-run workflow run {run_id} in {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Re-run all jobs of run {run_id} in {owner}/{repo} with debug logging {enable_debug_logging}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
          enable_debug_logging: requestBody.enable_debug_logging
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run_id}/rerun-failed-jobs'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-run only the failed jobs of a run
      effect: write
      questions:
      - Can I retry just the jobs that failed in a workflow run?
      - What's the way to re-run failed jobs and their dependents without redoing the passing ones?
      instructions:
      - text: Re-run the failed jobs in run {run_id} of {owner}/{repo}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
      - text: Retry failed jobs of run {run_id} in {owner}/{repo} with debug logging {enable_debug_logging}.
        slots:
          run_id: path.run_id
          owner: path.owner
          repo: path.repo
          enable_debug_logging: requestBody.enable_debug_logging
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List Actions secrets in a repository
      effect: read
      questions:
      - Which Actions secrets are defined on my repository?
      - Can I see a repo's secret names and when they were updated?
      instructions:
      - text: List Actions secrets in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show page {page} of repository secrets for {owner}/{repo}.
        slots:
          page: query.page
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/public-key'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the repo public key for encrypting secrets
      effect: read
      questions:
      - Which key do I use to encrypt a repository secret before uploading it?
      - Where do I get the key_id for a new repo secret?
      instructions:
      - text: Get the public key for repository {owner}/{repo} so I can encrypt a secret.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Look up the key_id and key for repo-level secrets in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/{secret_name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repo Actions secret's metadata
      effect: read
      questions:
      - When was a repository secret last changed?
      - Does a secret with a given name exist on my repo?
      instructions:
      - text: Get repository secret {secret_name} in {owner}/{repo}.
        slots:
          secret_name: path.secret_name
          owner: path.owner
          repo: path.repo
      - text: Show when secret {secret_name} in {owner}/{repo} was last updated.
        slots:
          secret_name: path.secret_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/{secret_name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a repo Actions secret
      effect: write
      questions:
      - How do I add an encrypted deploy key as a secret on my repository?
      - Can I rotate the value of an existing repo secret?
      instructions:
      - text: Save repo secret {secret_name} in {owner}/{repo} with encrypted value {encrypted_value}.
        slots:
          secret_name: path.secret_name
          owner: path.owner
          repo: path.repo
          encrypted_value: requestBody.encrypted_value
      - text: Set secret {secret_name} in {owner}/{repo} to {encrypted_value} encrypted with key {key_id}.
        slots:
          secret_name: path.secret_name
          owner: path.owner
          repo: path.repo
          encrypted_value: requestBody.encrypted_value
          key_id: requestBody.key_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/{secret_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repo Actions secret
      effect: destructive
      questions:
      - How do I remove an Actions secret from my repository?
      - Can I delete a repo secret that's no longer used?
      instructions:
      - text: Delete repository secret {secret_name} from {owner}/{repo}.
        slots:
          secret_name: path.secret_name
          owner: path.owner
          repo: path.repo
      - text: Remove the {secret_name} secret in {owner}/{repo}.
        slots:
          secret_name: path.secret_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List Actions variables in a repository
      effect: read
      questions:
      - Which configuration variables are defined on my repository?
      - What values do my repo's Actions variables hold?
      instructions:
      - text: List Actions variables in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show page {page} of repository variables for {owner}/{repo}.
        slots:
          page: query.page
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/variables'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a repo Actions variable
      effect: write
      questions:
      - How do I add a plain-text configuration variable to a single repository?
      - Can I store a non-secret setting for my repo's workflows to read?
      instructions:
      - text: Create repo variable {name} with value {value} in {owner}/{repo}.
        slots:
          name: requestBody.name
          value: requestBody.value
          owner: path.owner
          repo: path.repo
      - text: Add variable {name}={value} to {owner}/{repo}.
        slots:
          name: requestBody.name
          value: requestBody.value
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repo Actions variable
      effect: read
      questions:
      - What's the current value of a variable on my repository?
      - When was a repo variable last updated?
      instructions:
      - text: Get repository variable {name} in {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      - text: Show the value of variable {name} in {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repo Actions variable
      effect: destructive
      questions:
      - How do I delete a configuration variable from my repo?
      - Can I remove a repository variable by name?
      instructions:
      - text: Delete repository variable {name} from {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      - text: Remove the {name} variable in {owner}/{repo}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a repo Actions variable
      effect: write
      questions:
      - Can I change the value of an existing repository variable?
      - How do I rename a variable on my repo?
      instructions:
      - text: Update repo variable {name} in {owner}/{repo} to value {value}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
          value: requestBody.value
      - text: Rename repository variable {name} in {owner}/{repo} to {new_name}.
        slots:
          name: path.name
          owner: path.owner
          repo: path.repo
          new_name: requestBody.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows'].get
  update:
    x-apievangelist-phrasing:
      intent: List workflows in a repository
      effect: read
      questions:
      - Which workflows are defined in my repository?
      - Are any of my repo's workflows disabled?
      instructions:
      - text: List the workflows in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show page {page} of workflow definitions in {owner}/{repo}.
        slots:
          page: query.page
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow
      effect: read
      questions:
      - What state is a specific workflow in, active or disabled?
      - Can I look up a workflow by its file name like main.yaml?
      instructions:
      - text: Get workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Show details of the {workflow_id} workflow file in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- 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 pause a workflow so it stops running on new events?
      - Can I turn off a scheduled workflow without deleting its file?
      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_id} workflow in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches'].post
  update:
    x-apievangelist-phrasing:
      intent: Manually trigger a workflow run
      effect: write
      questions:
      - How do I start a workflow_dispatch workflow from a script?
      - Can I pass inputs when manually triggering a workflow on a branch?
      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_id} in {owner}/{repo} on ref {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-24'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable a workflow
      effect: write
      questions:
      - How do I turn a disabled workflow back on?
      - Can I reactivate a scheduled workflow GitHub disabled for inactivity?
      instructions:
      - text: Enable workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Reactivate the {workflow_id} workflow in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List runs of one workflow
      effect: read
      questions:
      - What are the recent runs of one specific workflow, like my deploy pipeline?
      - Can I see only failed runs of a single workflow on main?
      instructions:
      - text: List runs of workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Show only {status} runs of the {workflow_id} workflow on {branch} in {owner}/{repo}.
        slots:
          status: query.status
          workflow_id: path.workflow_id
          branch: query.branch
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List secrets in a deployment environment
      effect: read
      questions:
      - Which secrets are configured for my production environment?
      - Can I list an environment's secrets without revealing their values?
      instructions:
      - text: List secrets in environment {environment_name} of {owner}/{repo}.
        slots:
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Show page {page} of secrets for the {environment_name} environment in {owner}/{repo}.
        slots:
          page: query.page
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/secrets/public-key'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the environment public key for secrets
      effect: read
      questions:
      - Which key encrypts secrets for a specific deployment environment?
      - Where do I get the key_id before adding an environment secret?
      instructions:
      - text: Get the secrets public key for environment {environment_name} in {owner}/{repo}.
        slots:
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Look up the key that encrypts secrets for deployment environment {environment_name} in {owner}/{repo}.
        slots:
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/secrets/{secret_name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an environment secret's metadata
      effect: read
      questions:
      - When was a secret in my staging environment last updated?
      - Does a given secret exist in a particular environment?
      instructions:
      - text: Get secret {secret_name} in environment {environment_name} of {owner}/{repo}.
        slots:
          secret_name: path.secret_name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Show when {secret_name} in the {environment_name} environment of {owner}/{repo} last changed.
        slots:
          secret_name: path.secret_name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/secrets/{secret_name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an environment secret
      effect: write
      questions:
      - How do I add an encrypted secret that only production deployments can use?
      - Can I rotate a secret scoped to one environment?
      instructions:
      - text: Save secret {secret_name} in environment {environment_name} of {owner}/{repo} with value {encrypted_value} and key {key_id}.
        slots:
          secret_name: path.secret_name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
          encrypted_value: requestBody.encrypted_value
          key_id: requestBody.key_id
      - text: Rotate the {environment_name} environment secret {secret_name} in {owner}/{repo} to {encrypted_value} using key {key_id}.
        slots:
          environment_name: path.environment_name
          secret_name: path.secret_name
          owner: path.owner
          repo: path.repo
          encrypted_value: requestBody.encrypted_value
          key_id: requestBody.key_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/secrets/{secret_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an environment secret
      effect: destructive
      questions:
      - How do I remove a secret from a deployment environment?
      - Can I delete one environment's secret without touching repo secrets?
      instructions:
      - text: Delete secret {secret_name} from environment {environment_name} in {owner}/{repo}.
        slots:
          secret_name: path.secret_name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Remove {secret_name} from the {environment_name} environment of {owner}/{repo}.
        slots:
          secret_name: path.secret_name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List variables in a deployment environment
      effect: read
      questions:
      - Which configuration variables does my staging environment define?
      - What values are set on a particular environment's variables?
      instructions:
      - text: List variables in environment {environment_name} of {owner}/{repo}.
        slots:
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Show page {page} of variables for the {environment_name} environment in {owner}/{repo}.
        slots:
          page: query.page
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/variables'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an environment variable
      effect: write
      questions:
      - How do I add a configuration variable scoped to one deployment environment?
      - Can production and staging have different values for the same variable name?
      instructions:
      - text: Create variable {name} with value {value} in environment {environment_name} of {owner}/{repo}.
        slots:
          name: requestBody.name
          value: requestBody.value
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Add {name}={value} to the {environment_name} environment in {owner}/{repo}.
        slots:
          name: requestBody.name
          value: requestBody.value
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/variables/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an environment variable
      effect: read
      questions:
      - What value does a variable have in a given environment?
      - When was an environment variable last changed?
      instructions:
      - text: Get variable {name} in environment {environment_name} of {owner}/{repo}.
        slots:
          name: path.name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Show the value of {name} in the {environment_name} environment of {owner}/{repo}.
        slots:
          name: path.name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/variables/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an environment variable
      effect: destructive
      questions:
      - How do I remove a variable from one deployment environment?
      - Can I delete an environment-scoped variable by name?
      instructions:
      - text: Delete variable {name} from environment {environment_name} in {owner}/{repo}.
        slots:
          name: path.name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      - text: Drop the {name} variable from deployment environment {environment_name} in {owner}/{repo}.
        slots:
          name: path.name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-24'
- target: $.paths['/repos/{owner}/{repo}/environments/{environment_name}/variables/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an environment variable
      effect: write
      questions:
      - Can I change a variable's value in just one environment?
      - How do I rename a variable in a deployment environment?
      instructions:
      - text: Update variable {name} in environment {environment_name} of {owner}/{repo} to {value}.
        slots:
          name: path.name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
          value: requestBody.value
      - text: Rename {name} in the {environment_name} environment of {owner}/{repo} to {new_name}.
        slots:
          name: path.name
          environment_name: path.environment_name
          owner: path.owner
          repo: path.repo
          new_name: requestBody.name
      method: generated
      generated: '2026-09-24'