API Evangelist conversational phrasing for Gitea Organization 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 Organization API
  version: 1.0.0
extends: openapi/gitea-organization-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: 67
- target: $.paths['/org/{org}/repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an org repo via the legacy /org path
      effect: write
      questions:
      - Is there an older, deprecated /org endpoint for creating a repository under an organization?
      - Do legacy scripts that post to the singular /org path still create org repos?
      instructions:
      - text: Using the deprecated /org endpoint, create repository {name} in organization {org}.
        slots:
          name: requestBody.name
          org: path.org
      - text: Through the legacy singular-org path, make repo {name} under {org} with private set to {private}.
        slots:
          name: requestBody.name
          org: path.org
          private: requestBody.private
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs'].get
  update:
    x-apievangelist-phrasing:
      intent: List all organizations on the instance
      effect: read
      questions:
      - Which organizations exist on this Gitea server?
      - Can I page through every organization on the instance?
      instructions:
      - text: List all organizations on the server.
      - text: Show page {page} of every organization, {limit} per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an organization
      effect: write
      questions:
      - How do I create a new organization for my team?
      - Can I make an organization private or limited visibility when creating it?
      instructions:
      - text: Create an organization named {username}.
        slots:
          username: requestBody.username
      - text: Create organization {username} with display name {full_name} and visibility {visibility}.
        slots:
          username: requestBody.username
          full_name: requestBody.full_name
          visibility: requestBody.visibility
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization's profile
      effect: read
      questions:
      - What are the website, location and visibility settings of an organization?
      - Can I look up an organization's profile by its name?
      instructions:
      - text: Get organization {org}.
        slots:
          org: path.org
      - text: Show the profile details of the {org} organization.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization
      effect: destructive
      questions:
      - Can I delete an organization I no longer need?
      - What does it take to remove an organization entirely?
      instructions:
      - text: Delete organization {org}.
        slots:
          org: path.org
      - text: Permanently remove the {org} organization.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an organization's profile settings
      effect: write
      questions:
      - Can I change an organization's description, website or contact email?
      - Is it possible to switch an organization from public to private visibility?
      instructions:
      - text: Set the website of organization {org} to {website}.
        slots:
          org: path.org
          website: requestBody.website
      - text: Change {org}'s visibility to {visibility} and description to {description}.
        slots:
          org: path.org
          visibility: requestBody.visibility
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's Actions workflow jobs
      effect: read
      questions:
      - Which Actions jobs are running or queued across an organization?
      - Can I filter org-wide workflow jobs by status?
      instructions:
      - text: List the Actions workflow jobs for organization {org}.
        slots:
          org: path.org
      - text: Show {status} workflow jobs across {org}.
        slots:
          status: query.status
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/runners'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's Actions runners
      effect: read
      questions:
      - What self-hosted runners are registered to an organization?
      - Can I see only the disabled runners for an org?
      instructions:
      - text: List the Actions runners for organization {org}.
        slots:
          org: path.org
      - text: Show runners in {org} where disabled is {disabled}.
        slots:
          disabled: query.disabled
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/runners/registration-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a runner registration token for an org
      effect: write
      questions:
      - How do I get a token to register a new self-hosted runner for my organization?
      - Where does the registration token for an org-level runner come from?
      instructions:
      - text: Generate a runner registration token for organization {org}.
        slots:
          org: path.org
      - text: Give me a token to register an Actions runner under {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of an organization's runners
      effect: read
      questions:
      - Is a specific org runner online, and what labels does it have?
      - Can I look up a single runner in an organization by ID?
      instructions:
      - text: Get runner {runner_id} in organization {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      - text: Show the status of {org}'s runner {runner_id}.
        slots:
          runner_id: path.runner_id
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a runner from an organization
      effect: destructive
      questions:
      - How do I unregister a retired runner from my organization?
      - Can I delete an org-level runner that's no longer in use?
      instructions:
      - text: Delete runner {runner_id} from organization {org}.
        slots:
          runner_id: path.runner_id
          org: path.org
      - text: Unregister {org}'s Actions runner {runner_id}.
        slots:
          runner_id: path.runner_id
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/runners/{runner_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable an organization runner
      effect: write
      questions:
      - Can I temporarily disable an org runner so it stops picking up jobs?
      - How do I re-enable a disabled runner in an organization?
      instructions:
      - text: Disable runner {runner_id} in organization {org} by setting disabled to {disabled}.
        slots:
          runner_id: path.runner_id
          org: path.org
          disabled: requestBody.disabled
      - text: Set the disabled flag of {org}'s runner {runner_id} to {disabled}.
        slots:
          runner_id: path.runner_id
          org: path.org
          disabled: requestBody.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's Actions workflow runs
      effect: read
      questions:
      - Which workflow runs have happened across all of an organization's repos?
      - Can I filter org workflow runs by branch, event, actor or commit SHA?
      instructions:
      - text: List workflow runs for organization {org}.
        slots:
          org: path.org
      - text: Show {org}'s workflow runs on branch {branch} with status {status}.
        slots:
          org: path.org
          branch: query.branch
          status: query.status
      - text: Find runs in {org} triggered by {actor}.
        slots:
          org: path.org
          actor: query.actor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's Actions secrets
      effect: read
      questions:
      - What Actions secrets are defined at the organization level?
      - Can I see the names of an org's secrets without their values?
      instructions:
      - text: List the Actions secrets for organization {org}.
        slots:
          org: path.org
      - text: Show which secret names exist in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/secrets/{secretname}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an organization secret
      effect: write
      questions:
      - How do I add a deployment secret shared by all of my organization's workflows?
      - Can I rotate the value of an existing org Actions secret?
      instructions:
      - text: Set org secret {secretname} in {org} to {data}.
        slots:
          secretname: path.secretname
          org: path.org
          data: requestBody.data
      - text: Rotate {org}'s Actions secret {secretname} to the new value {data}.
        slots:
          secretname: path.secretname
          org: path.org
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/secrets/{secretname}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization secret
      effect: destructive
      questions:
      - Can I remove an Actions secret from my organization?
      - How do I delete a leaked org-level secret?
      instructions:
      - text: Delete secret {secretname} from organization {org}.
        slots:
          secretname: path.secretname
          org: path.org
      - text: Remove {org}'s Actions secret {secretname}.
        slots:
          secretname: path.secretname
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's Actions variables
      effect: read
      questions:
      - What Actions variables are configured for an organization?
      - Can I view the org-level workflow variables and their values?
      instructions:
      - text: List the Actions variables for organization {org}.
        slots:
          org: path.org
      - text: Show all workflow variables defined in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/variables/{variablename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one organization Actions variable
      effect: read
      questions:
      - What value does a specific org-level variable hold?
      - Can I read a single Actions variable from an organization by name?
      instructions:
      - text: Get variable {variablename} in organization {org}.
        slots:
          variablename: path.variablename
          org: path.org
      - text: Show the value of {org}'s Actions variable {variablename}.
        slots:
          variablename: path.variablename
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/variables/{variablename}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing organization variable
      effect: write
      questions:
      - Can I change the value of an existing org Actions variable?
      - Is it possible to rename an organization variable when updating it?
      instructions:
      - text: Update existing variable {variablename} in {org} to {value}.
        slots:
          variablename: path.variablename
          org: path.org
          value: requestBody.value
      - text: Rename {org}'s variable {variablename} to {name} and set it to {value}.
        slots:
          variablename: path.variablename
          org: path.org
          name: requestBody.name
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/variables/{variablename}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new organization Actions variable
      effect: write
      questions:
      - How do I add a new workflow variable shared across an organization?
      - Can I give a new org-level variable a description?
      instructions:
      - text: Create a new variable {variablename} in organization {org} with value {value}.
        slots:
          variablename: path.variablename
          org: path.org
          value: requestBody.value
      - text: Add org variable {variablename} to {org} set to {value}, described as {description}.
        slots:
          variablename: path.variablename
          org: path.org
          value: requestBody.value
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/actions/variables/{variablename}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization Actions variable
      effect: destructive
      questions:
      - Can I remove an Actions variable from my organization?
      - What's the way to delete an unused org variable?
      instructions:
      - text: Delete variable {variablename} from organization {org}.
        slots:
          variablename: path.variablename
          org: path.org
      - text: Remove {org}'s Actions variable {variablename}.
        slots:
          variablename: path.variablename
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/activities/feeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's activity feed
      effect: read
      questions:
      - What has been happening recently in an organization?
      - Can I see an organization's activity for a specific date?
      instructions:
      - text: Show the activity feed for organization {org}.
        slots:
          org: path.org
      - text: List {org}'s activity on {date}.
        slots:
          org: path.org
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/avatar'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload an organization's avatar
      effect: write
      questions:
      - How do I set a logo for my organization?
      - Can I replace an organization's avatar image?
      instructions:
      - text: Set the avatar of organization {org} to {image}.
        slots:
          org: path.org
          image: requestBody.image
      - text: Upload {image} as the logo for {org}.
        slots:
          org: path.org
          image: requestBody.image
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/avatar'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an organization's avatar
      effect: destructive
      questions:
      - Can I reset an organization's avatar back to the default?
      - Is there a way to delete an org's uploaded logo?
      instructions:
      - text: Delete the avatar of organization {org}.
        slots:
          org: path.org
      - text: Reset {org}'s logo to the default.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/blocks'].get
  update:
    x-apievangelist-phrasing:
      intent: List users blocked by an organization
      effect: read
      questions:
      - Which users has my organization blocked?
      - Can I review the blocklist of an org?
      instructions:
      - text: List users blocked by organization {org}.
        slots:
          org: path.org
      - text: Show {org}'s blocklist.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/blocks/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if an organization has blocked a user
      effect: read
      questions:
      - Is a particular user blocked by my organization?
      - Can I confirm whether someone is on an org's blocklist?
      instructions:
      - text: Check whether {username} is blocked by organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Tell me if {org} has blocked {username}.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/blocks/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Block a user from an organization
      effect: write
      questions:
      - How do I block an abusive user from interacting with my organization?
      - Can I attach a note explaining why an org blocked someone?
      instructions:
      - text: Block {username} from organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Have {org} block {username} with the note {note}.
        slots:
          username: path.username
          org: path.org
          note: query.note
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/blocks/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unblock a user from an organization
      effect: destructive
      questions:
      - Can I lift an organization's block on a user?
      - How would I let a previously blocked person interact with my org again?
      instructions:
      - text: Unblock {username} in organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Remove {username} from {org}'s blocklist.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/hooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's webhooks
      effect: read
      questions:
      - Which webhooks are configured at the organization level?
      - Can I see where an org's webhook events are being sent?
      instructions:
      - text: List the webhooks for organization {org}.
        slots:
          org: path.org
      - text: Show all org-level hooks configured in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/hooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an organization webhook
      effect: write
      questions:
      - How do I send events from every repo in my organization to one webhook URL?
      - Can an org webhook be limited to certain events or branches?
      instructions:
      - text: Create a {type} webhook in organization {org} with config {config}.
        slots:
          type: requestBody.type
          org: path.org
          config: requestBody.config
      - text: Add a {type} hook to {org} using {config} for events {events} on branches {branch_filter}.
        slots:
          type: requestBody.type
          org: path.org
          config: requestBody.config
          events: requestBody.events
          branch_filter: requestBody.branch_filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/hooks/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization webhook
      effect: read
      questions:
      - What events and target URL does a specific org webhook use?
      - Is a given organization webhook active?
      instructions:
      - text: Get webhook {id} in organization {org}.
        slots:
          id: path.id
          org: path.org
      - text: Show the configuration of {org}'s hook {id}.
        slots:
          id: path.id
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/hooks/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization webhook
      effect: destructive
      questions:
      - Can I remove a webhook from my organization?
      - How do I stop an org webhook from firing permanently?
      instructions:
      - text: Delete webhook {id} from organization {org}.
        slots:
          id: path.id
          org: path.org
      - text: Remove {org}'s hook {id}.
        slots:
          id: path.id
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/hooks/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an organization webhook
      effect: write
      questions:
      - Can I change which events an org webhook subscribes to?
      - Is it possible to pause an organization webhook by marking it inactive?
      instructions:
      - text: Set active to {active} on webhook {id} in organization {org}.
        slots:
          active: requestBody.active
          id: path.id
          org: path.org
      - text: Change {org}'s hook {id} to fire on events {events}.
        slots:
          events: requestBody.events
          id: path.id
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's shared labels
      effect: read
      questions:
      - What labels are defined at the organization level for all its repos?
      - Can I see the org-wide label set?
      instructions:
      - text: List the labels of organization {org}.
        slots:
          org: path.org
      - text: Show the org-wide labels available across {org}'s repos.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an organization-wide label
      effect: write
      questions:
      - How do I create a label that every repo in my organization can use?
      - Can an org-level label be exclusive within its scope?
      instructions:
      - text: Create org label {name} with color {color} in {org}.
        slots:
          name: requestBody.name
          color: requestBody.color
          org: path.org
      - text: Add an organization-wide label {name} colored {color} to {org}, described as {description}.
        slots:
          name: requestBody.name
          color: requestBody.color
          org: path.org
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/labels/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization label
      effect: read
      questions:
      - What color and description does an org-level label have?
      - Can I look up one of my organization's labels by ID?
      instructions:
      - text: Get org label {id} in {org}.
        slots:
          id: path.id
          org: path.org
      - text: Show the details of organization label {id} in {org}.
        slots:
          id: path.id
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/labels/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization label
      effect: destructive
      questions:
      - Can I delete an org-wide label that's no longer used?
      - How do I remove a label from the organization's shared set?
      instructions:
      - text: Delete org label {id} from {org}.
        slots:
          id: path.id
          org: path.org
      - text: Remove organization-wide label {id} in {org}.
        slots:
          id: path.id
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/labels/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an organization label
      effect: write
      questions:
      - Can I rename or recolor a label shared across my organization?
      - Is archiving an org-level label supported?
      instructions:
      - text: Rename org label {id} in {org} to {name}.
        slots:
          id: path.id
          org: path.org
          name: requestBody.name
      - text: Change the color of organization label {id} in {org} to {color}.
        slots:
          id: path.id
          org: path.org
          color: requestBody.color
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's members
      effect: read
      questions:
      - Who belongs to an organization, including private members?
      - How many people are members of my org?
      instructions:
      - text: List all members of organization {org}.
        slots:
          org: path.org
      - text: Show everyone who belongs to {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/members/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a user is an organization member
      effect: read
      questions:
      - Is a specific user a member of my organization?
      - Can I verify someone's org membership before granting access?
      instructions:
      - text: Check whether {username} is a member of organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Tell me if {username} belongs to {org}.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/members/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member from an organization
      effect: destructive
      questions:
      - How do I remove someone who has left the company from our organization?
      - Can I kick a user out of an org?
      instructions:
      - text: Remove {username} from organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Revoke {username}'s membership in {org}.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/public_members'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's public members
      effect: read
      questions:
      - Which members have made their organization membership public?
      - Who shows up as a visible member of an org?
      instructions:
      - text: List the public members of organization {org}.
        slots:
          org: path.org
      - text: Show only the publicly visible members of {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/public_members/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a user's org membership is public
      effect: read
      questions:
      - Is a user's membership in an organization publicly visible?
      - Can I check if someone shows as a public member of an org?
      instructions:
      - text: Check whether {username} shows publicly as part of organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Tell me if {username}'s membership in {org} is public.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/public_members/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a user's org membership public
      effect: write
      questions:
      - How do I make my membership in an organization visible on my profile?
      - Can I publicize a member's organization membership?
      instructions:
      - text: Make {username}'s membership in organization {org} public.
        slots:
          username: path.username
          org: path.org
      - text: Publicize that {username} belongs to {org}.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/public_members/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Hide a user's org membership
      effect: destructive
      questions:
      - Can I hide my membership in an organization from the public?
      - Is it possible to make an org membership private again?
      instructions:
      - text: Conceal {username}'s membership in organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Make {username}'s membership in {org} private.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/rename'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename an organization
      effect: write
      questions:
      - Can I change the name of an organization after it's been created?
      - How do I rename my org to match our new company name?
      instructions:
      - text: Rename organization {org} to {new_name}.
        slots:
          org: path.org
          new_name: requestBody.new_name
      - text: Change the name of {org} to {new_name}.
        slots:
          org: path.org
          new_name: requestBody.new_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's repositories
      effect: read
      questions:
      - What repositories does an organization own?
      - Can I page through every repo in my org?
      instructions:
      - text: List the repositories in organization {org}.
        slots:
          org: path.org
      - text: Show all repos owned by {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'


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