# 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'
- target: $.paths['/orgs/{org}/repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a repository in an organization
      effect: write
      questions:
      - How do I create a new repository owned by my organization?
      - Can I auto-initialize an org repo with a README, license and .gitignore?
      - Is it possible to choose SHA-256 object format for a new organization repo?
      instructions:
      - text: Create repository {name} in organization {org}.
        slots:
          name: requestBody.name
          org: path.org
      - text: Create repo {name} under {org}, initialized with license {license} and gitignore {gitignores}.
        slots:
          name: requestBody.name
          org: path.org
          license: requestBody.license
          gitignores: requestBody.gitignores
      - text: Make a new {org} repository {name} with default branch {default_branch}.
        slots:
          name: requestBody.name
          org: path.org
          default_branch: requestBody.default_branch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/repos'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete every repository in an organization
      effect: destructive
      questions:
      - Is there a way to wipe out all of an organization's repositories at once?
      - Can I bulk-delete every repo in an org before shutting it down?
      instructions:
      - text: Delete all repositories in organization {org}.
        slots:
          org: path.org
      - text: Wipe every repo owned by {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's teams
      effect: read
      questions:
      - Which teams exist in an organization?
      - Can I get the full list of teams in my org?
      instructions:
      - text: List the teams in organization {org}.
        slots:
          org: path.org
      - text: Show all of {org}'s teams.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/teams'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a team in an organization
      effect: write
      questions:
      - How do I create a team with write access to all of our org's repos?
      - Can a new team be allowed to create repositories in the organization?
      instructions:
      - text: Create team {name} in organization {org}.
        slots:
          name: requestBody.name
          org: path.org
      - text: Create team {name} in {org} with {permission} permission on all repositories set to {includes_all_repositories}.
        slots:
          name: requestBody.name
          org: path.org
          permission: requestBody.permission
          includes_all_repositories: requestBody.includes_all_repositories
      method: generated
      generated: '2026-09-26'
- target: $.paths['/orgs/{org}/teams/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search teams in an organization
      effect: read
      questions:
      - Can I find a team in my org by typing part of its name?
      - Is it possible to search team descriptions as well as names?
      instructions:
      - text: Search organization {org} for teams matching {q}.
        slots:
          org: path.org
          q: query.q
      - text: Find {org} teams whose name or description mentions {q}, with include_desc {include_desc}.
        slots:
          org: path.org
          q: query.q
          include_desc: query.include_desc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a team's details
      effect: read
      questions:
      - What permissions and units does a particular team have?
      - Can I look up a team by its numeric ID?
      instructions:
      - text: Get team {id}.
        slots:
          id: path.id
      - text: Show the permission settings of team {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a team
      effect: destructive
      questions:
      - Can I delete a team that's no longer needed?
      - How do I disband a team in an organization?
      instructions:
      - text: Delete team {id}.
        slots:
          id: path.id
      - text: Disband the team with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a team's name and permissions
      effect: write
      questions:
      - Can I change a team's permission level from read to write?
      - Is renaming an existing team supported?
      instructions:
      - text: Rename team {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Update team {id} named {name} to have {permission} permission.
        slots:
          id: path.id
          name: requestBody.name
          permission: requestBody.permission
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/activities/feeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List a team's activity feed
      effect: read
      questions:
      - What has a particular team been working on recently?
      - Can I see a team's activity for one day?
      instructions:
      - text: Show the activity feed of team {id}.
        slots:
          id: path.id
      - text: List team {id}'s activity on {date}.
        slots:
          id: path.id
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List a team's members
      effect: read
      questions:
      - Who is on a given team?
      - Can I list all the members of a team?
      instructions:
      - text: List the members of team {id}.
        slots:
          id: path.id
      - text: Show everyone on team {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/members/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a specific user on a team
      effect: read
      questions:
      - Is a particular user on a given team?
      - Can I fetch one member's record from a team?
      instructions:
      - text: Check whether {username} is on team {id}.
        slots:
          username: path.username
          id: path.id
      - text: Get {username}'s membership in team {id}.
        slots:
          username: path.username
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/members/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a user to a team
      effect: write
      questions:
      - How do I add a new hire to a team?
      - Can I put an existing org member onto another team?
      instructions:
      - text: Add {username} to team {id}.
        slots:
          username: path.username
          id: path.id
      - text: Put user {username} on team {id}.
        slots:
          username: path.username
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/members/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from a team
      effect: destructive
      questions:
      - Can I take someone off a team without removing them from the organization?
      - How do I drop a user from a team?
      instructions:
      - text: Remove {username} from team {id}.
        slots:
          username: path.username
          id: path.id
      - text: Take user {username} off team {id}.
        slots:
          username: path.username
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List a team's repositories
      effect: read
      questions:
      - Which repositories does a team have access to?
      - Can I list every repo assigned to a team?
      instructions:
      - text: List the repositories of team {id}.
        slots:
          id: path.id
      - text: Show every repo team {id} can access.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/repos/{org}/{repo}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a team has a specific repository
      effect: read
      questions:
      - Does a given team have access to a particular repository?
      - Can I confirm a repo is assigned to a team?
      instructions:
      - text: Check whether team {id} has repository {org}/{repo}.
        slots:
          id: path.id
          org: path.org
          repo: path.repo
      - text: Get repo {repo} of {org} as seen by team {id}.
        slots:
          id: path.id
          org: path.org
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/repos/{org}/{repo}'].put
  update:
    x-apievangelist-phrasing:
      intent: Give a team access to a repository
      effect: write
      questions:
      - How do I grant a team access to one of our repositories?
      - Can I add a repo to a team's list of repositories?
      instructions:
      - text: Add repository {org}/{repo} to team {id}.
        slots:
          id: path.id
          org: path.org
          repo: path.repo
      - text: Grant team {id} access to repo {repo} in {org}.
        slots:
          id: path.id
          org: path.org
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{id}/repos/{org}/{repo}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a repository from a team
      effect: destructive
      questions:
      - Can I revoke a team's access to a repo without deleting the repository?
      - Does removing a repo from a team delete the repo itself?
      instructions:
      - text: Remove repository {org}/{repo} from team {id}.
        slots:
          id: path.id
          org: path.org
          repo: path.repo
      - text: Revoke team {id}'s access to repo {repo} in {org}, keeping the repo.
        slots:
          id: path.id
          org: path.org
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/orgs'].get
  update:
    x-apievangelist-phrasing:
      intent: List the organizations I belong to
      effect: read
      questions:
      - Which organizations am I a member of?
      - Can I list my own orgs as the signed-in user?
      instructions:
      - text: List my organizations.
      - text: Show page {page} of the orgs I belong to.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/orgs'].get
  update:
    x-apievangelist-phrasing:
      intent: List another user's organizations
      effect: read
      questions:
      - Which organizations does a particular user belong to?
      - Can I see the orgs listed on someone else's profile?
      instructions:
      - text: List the organizations of user {username}.
        slots:
          username: path.username
      - text: Show which orgs {username} is part of.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/orgs/{org}/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's permissions in an organization
      effect: read
      questions:
      - Is a user an owner or admin of an organization, and can they create repos there?
      - What permissions does someone have in a given org?
      instructions:
      - text: Get {username}'s permissions in organization {org}.
        slots:
          username: path.username
          org: path.org
      - text: Show whether {username} can administer or create repos in {org}.
        slots:
          username: path.username
          org: path.org
      method: generated
      generated: '2026-09-26'