API Evangelist conversational phrasing for Gitea Repository API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gitea Repository API
  version: 1.0.0
extends: openapi/gitea-repository-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 197
- target: $.paths['/repos/migrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a remote git repository
      effect: write
      questions:
      - How do I import an existing repository from another git server into Gitea?
      - Can a migration also bring over issues, labels, milestones, releases and the wiki?
      - Is it possible to migrate a remote repo as a mirror that keeps syncing on an interval?
      instructions:
      - text: Migrate the repository at {clone_addr} into a new repo called {repo_name}.
        slots:
          clone_addr: requestBody.clone_addr
          repo_name: requestBody.repo_name
      - text: Import {clone_addr} as {repo_name} under {repo_owner}, including its issues and pull requests.
        slots:
          clone_addr: requestBody.clone_addr
          repo_name: requestBody.repo_name
          repo_owner: requestBody.repo_owner
      - text: Set up {clone_addr} as a pull mirror named {repo_name} that syncs every {mirror_interval}.
        slots:
          clone_addr: requestBody.clone_addr
          repo_name: requestBody.repo_name
          mirror_interval: requestBody.mirror_interval
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search repositories
      effect: read
      questions:
      - What's the way to find repositories matching a keyword across the whole instance?
      - Can I search repos by topic and include their descriptions in the match?
      - Which repositories has a given user starred, or are archived or templates?
      instructions:
      - text: Search all repositories for {q}.
        slots:
          q: query.q
      - text: Find repositories tagged with topic {q}, sorted by {sort}.
        slots:
          q: query.q
          sort: query.sort
      - text: Search for template repositories matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's details
      effect: read
      questions:
      - How can I look up the details of a single repository, like its default branch and visibility?
      - What settings and metadata does a repository expose when I fetch it by owner and name?
      instructions:
      - text: Show me the details of repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Get the default branch and visibility of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository
      effect: destructive
      questions:
      - How do I permanently delete a repository?
      - Can a deleted repository be recovered afterwards?
      instructions:
      - text: Delete the repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Permanently remove {owner}/{repo} and all of its content.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a repository's settings
      effect: write
      questions:
      - Can I rename a repository or change its description and website?
      - How do I archive a repo or make it private after it was created?
      - Which merge styles can I allow or disallow on a repository, like squash or rebase?
      - Is it possible to turn off the wiki, issues or pull requests for one repo?
      instructions:
      - text: Rename repository {owner}/{repo} to {name}.
        slots:
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      - text: Archive the repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Change the default branch of {owner}/{repo} to {default_branch}.
        slots:
          owner: path.owner
          repo: path.repo
          default_branch: requestBody.default_branch
      - text: Set the description of {owner}/{repo} to {description}.
        slots:
          owner: path.owner
          repo: path.repo
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions artifacts
      effect: read
      questions:
      - What build artifacts have Actions workflows produced in this repository?
      - Can I filter a repository's workflow artifacts by name?
      instructions:
      - text: List all Actions artifacts in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Find artifacts named {name} across every run in {owner}/{repo}.
        slots:
          name: query.name
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Actions artifact
      effect: read
      questions:
      - How do I see the metadata of a single workflow artifact, like its size and expiry?
      - Which run produced a given artifact?
      instructions:
      - text: Show artifact {artifact_id} in {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Get the size and expiry details of artifact {artifact_id} from {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Actions artifact
      effect: destructive
      questions:
      - How can I delete a workflow artifact I no longer need to free up storage?
      - Can I remove a single build artifact without deleting the whole run?
      instructions:
      - text: Delete artifact {artifact_id} from {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Remove the workflow artifact {artifact_id} in {owner}/{repo} to free space.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip'].get
  update:
    x-apievangelist-phrasing:
      intent: Download an Actions artifact as a zip
      effect: read
      questions:
      - How do I download the zip file of a workflow artifact?
      - Where does the artifact download redirect me to get the actual file?
      instructions:
      - text: Download artifact {artifact_id} from {owner}/{repo} as a zip.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      - text: Fetch the zip archive for artifact {artifact_id} in {owner}/{repo}.
        slots:
          artifact_id: path.artifact_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's workflow jobs
      effect: read
      questions:
      - Which Actions jobs have run across the whole repository recently?
      - Can I list only the jobs in a certain status, such as queued or failed, for a repo?
      instructions:
      - text: List all workflow jobs in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show jobs in {owner}/{repo} with status {status}.
        slots:
          owner: path.owner
          repo: path.repo
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs/{job_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one workflow job
      effect: read
      questions:
      - How do I check the status and steps of a single Actions job?
      - What runner did a particular workflow job run on?
      instructions:
      - text: Show workflow job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      - text: Get the status and steps of job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/jobs/{job_id}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a workflow job's logs
      effect: read
      questions:
      - How can I get the log output of an Actions job to see why it failed?
      - Can I download the full logs of one job in a workflow run?
      instructions:
      - text: Download the logs for job {job_id} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      - text: Fetch the log output of workflow job {job_id} from {owner}/{repo}.
        slots:
          job_id: path.job_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions runners
      effect: read
      questions:
      - Which self-hosted runners are registered to this repository?
      - Can I list only the disabled runners attached to a repo?
      instructions:
      - text: List the Actions runners registered to {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show disabled runners for {owner}/{repo}, filtering on {disabled}.
        slots:
          owner: path.owner
          repo: path.repo
          disabled: query.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/registration-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a runner registration token for a repo
      effect: write
      questions:
      - How do I get a token to register a new self-hosted runner for a repository?
      - Where does the registration token for connecting a runner to one repo come from?
      instructions:
      - text: Generate a runner registration token for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Create a new Actions runner registration token in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository runner
      effect: read
      questions:
      - How can I check the status and labels of one runner attached to a repo?
      - Is a specific repository runner online or disabled?
      instructions:
      - text: Show runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Check whether runner {runner_id} for {owner}/{repo} is online.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a repository runner
      effect: destructive
      questions:
      - How do I unregister a self-hosted runner from a repository?
      - Can I remove a runner that's no longer used by one repo?
      instructions:
      - text: Delete runner {runner_id} from {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      - text: Unregister the Actions runner {runner_id} in {owner}/{repo}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runners/{runner_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable a repository runner
      effect: write
      questions:
      - Can I temporarily disable a repository's runner so it stops picking up jobs?
      - How do I re-enable a runner I previously disabled on a repo?
      instructions:
      - text: Disable runner {runner_id} in {owner}/{repo} by setting disabled to {disabled}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          disabled: requestBody.disabled
      - text: Re-enable Actions runner {runner_id} for {owner}/{repo} with disabled {disabled}.
        slots:
          runner_id: path.runner_id
          owner: path.owner
          repo: path.repo
          disabled: requestBody.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's workflow runs
      effect: read
      questions:
      - Which Actions runs have happened in a repo, and can I filter them by branch or event?
      - How can I find the workflow runs triggered by a specific commit SHA or actor?
      instructions:
      - text: List workflow runs in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show runs in {owner}/{repo} on branch {branch} with status {status}.
        slots:
          owner: path.owner
          repo: path.repo
          branch: query.branch
          status: query.status
      - text: Find workflow runs in {owner}/{repo} for commit {head_sha}.
        slots:
          owner: path.owner
          repo: path.repo
          head_sha: query.head_sha
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow run
      effect: read
      questions:
      - How do I check the outcome and timing of one workflow run?
      - What triggered a particular Actions run and did it succeed?
      instructions:
      - text: Show workflow run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Get the conclusion of run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workflow run
      effect: destructive
      questions:
      - Can I delete an old workflow run from a repository's Actions history?
      - How do I clean up a run I no longer want to keep?
      instructions:
      - text: Delete workflow run {run} from {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Remove Actions run {run} and its history in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifacts from one workflow run
      effect: read
      questions:
      - Which artifacts did a single workflow run upload?
      - Can I filter the artifacts of one run by artifact name?
      instructions:
      - text: List the artifacts produced by run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Find the artifact named {name} from run {run} in {owner}/{repo}.
        slots:
          name: query.name
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List jobs in a workflow run
      effect: read
      questions:
      - What jobs make up a particular workflow run and how did each one do?
      - Can I see only the failed jobs inside one run?
      instructions:
      - text: List the jobs in workflow run {run} of {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Show jobs with status {status} in run {run} of {owner}/{repo}.
        slots:
          status: query.status
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/jobs/{job_id}/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun a single job in a workflow run
      effect: write
      questions:
      - Can I rerun just one job in a run instead of the whole workflow?
      - How do I retry a single flaky job?
      instructions:
      - text: Rerun job {job_id} in run {run} of {owner}/{repo}.
        slots:
          job_id: path.job_id
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Retry only job {job_id} from workflow run {run} in {owner}/{repo}.
        slots:
          job_id: path.job_id
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun an entire workflow run
      effect: write
      questions:
      - How do I rerun every job in a workflow run from scratch?
      - Is there a way to restart a whole Actions run?
      instructions:
      - text: Rerun the entire workflow run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Restart all jobs of run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/runs/{run}/rerun-failed-jobs'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun the failed jobs of a workflow run
      effect: write
      questions:
      - Can I rerun only the jobs that failed in a run and keep the ones that passed?
      - What's the quickest way to retry the failures from one workflow run?
      instructions:
      - text: Rerun the failed jobs of run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      - text: Retry every failed job from workflow run {run} in {owner}/{repo}.
        slots:
          run: path.run
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions secrets
      effect: read
      questions:
      - Which Actions secrets are defined on a repository?
      - Can I see the names of repo secrets without their values?
      instructions:
      - text: List the Actions secrets for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the secret names configured in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/{secretname}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a repository secret
      effect: write
      questions:
      - How do I add an Actions secret, like a deploy token, to a repository?
      - Can I overwrite the value of an existing repo secret?
      instructions:
      - text: Set secret {secretname} in {owner}/{repo} to {data}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
          data: requestBody.data
      - text: Create the Actions secret {secretname} for {owner}/{repo} with value {data} and description {description}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
          data: requestBody.data
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/secrets/{secretname}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository secret
      effect: destructive
      questions:
      - How can I remove an Actions secret from a repository?
      - Will deleting a repo secret break workflows that reference it?
      instructions:
      - text: Delete the secret {secretname} from {owner}/{repo}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
      - text: Remove Actions secret {secretname} in {owner}/{repo}.
        slots:
          secretname: path.secretname
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/tasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions tasks
      effect: read
      questions:
      - What Actions tasks have been executed for a repository?
      - Can I page through the task history of a repo's Actions?
      instructions:
      - text: List the Actions tasks for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show the next {limit} Actions tasks for {owner}/{repo}.
        slots:
          limit: query.limit
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's Actions variables
      effect: read
      questions:
      - Which Actions configuration variables does a repository define?
      - Can I list all repo-level variables available to workflows?
      instructions:
      - text: List the Actions variables in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show all repo-level workflow variables for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository Actions variable
      effect: read
      questions:
      - How do I read the current value of one repo-level variable?
      - What is a specific Actions variable set to on a repository?
      instructions:
      - text: Get the variable {variablename} in {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      - text: Show the value of Actions variable {variablename} for {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a repository Actions variable
      effect: write
      questions:
      - Can I change the value of a repo variable that already exists?
      - How do I rename an existing Actions variable on a repository?
      instructions:
      - text: Change existing variable {variablename} in {owner}/{repo} to {value}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
          value: requestBody.value
      - text: Rename Actions variable {variablename} in {owner}/{repo} to {name} with value {value}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
          name: requestBody.name
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a repository Actions variable
      effect: write
      questions:
      - How do I add a new configuration variable for a repo's workflows?
      - Can I give a new repo-level variable a description when creating it?
      instructions:
      - text: Create a new variable {variablename} in {owner}/{repo} with value {value}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
          value: requestBody.value
      - text: Add Actions variable {variablename} = {value} to {owner}/{repo} described as {description}.
        slots:
          variablename: path.variablename
          value: requestBody.value
          owner: path.owner
          repo: path.repo
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/variables/{variablename}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository Actions variable
      effect: destructive
      questions:
      - How can I remove a repo-level Actions variable?
      - Is it possible to delete a workflow variable I no longer use?
      instructions:
      - text: Delete the variable {variablename} from {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      - text: Remove Actions variable {variablename} in {owner}/{repo}.
        slots:
          variablename: path.variablename
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's workflows
      effect: read
      questions:
      - Which workflow files are defined in a repository?
      - Can I see all Actions workflows a repo has and whether they're enabled?
      instructions:
      - text: List the workflows in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show every Actions workflow file defined in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow
      effect: read
      questions:
      - How do I look up one workflow's details, like its path and state?
      - Is a particular workflow currently active?
      instructions:
      - text: Show workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Get the state and path of workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable'].put
  update:
    x-apievangelist-phrasing:
      intent: Disable a workflow
      effect: write
      questions:
      - How do I stop a workflow from running without deleting its file?
      - Can I pause a scheduled workflow in a repository?
      instructions:
      - text: Disable workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Turn off the workflow {workflow_id} for {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches'].post
  update:
    x-apievangelist-phrasing:
      intent: Manually trigger a workflow
      effect: write
      questions:
      - How do I kick off a workflow manually on a chosen branch or tag?
      - Can I pass inputs when triggering a workflow dispatch event?
      - Does triggering a workflow return the details of the run it created?
      instructions:
      - text: Trigger workflow {workflow_id} in {owner}/{repo} on {ref}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
          ref: requestBody.ref
      - text: Dispatch workflow {workflow_id} in {owner}/{repo} on {ref} with inputs {inputs}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
          ref: requestBody.ref
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable a workflow
      effect: write
      questions:
      - How can I turn a disabled workflow back on?
      - Can I resume a workflow that was paused?
      instructions:
      - text: Enable workflow {workflow_id} in {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      - text: Re-activate the disabled workflow {workflow_id} for {owner}/{repo}.
        slots:
          workflow_id: path.workflow_id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/activities/feeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's activity feed
      effect: read
      questions:
      - What has been happening in a repository lately, like pushes and merged PRs?
      - Can I see a repo's activity for one specific date?
      instructions:
      - text: Show the activity feed for {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: List activity in {owner}/{repo} on {date}.
        slots:
          owner: path.owner
          repo: path.repo
          date: query.date
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (147 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/overlays/gitea-repository-api-phrasing-overlay.yaml