API Evangelist conversational phrasing for Gitea Issue 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 Issue API
  version: 1.0.0
extends: openapi/gitea-issue-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: 69
- target: $.paths['/repos/issues/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search issues across all my accessible repos
      effect: read
      questions:
      - Can I search issues across every Gitea repository I have access to at once?
      - Which open issues assigned to me exist across all my repos?
      - Is there a way to find issues where I'm mentioned or my review is requested, regardless of repo?
      instructions:
      - text: Search all my accessible repositories for issues matching {q}.
        slots:
          q: query.q
      - text: Find open issues across every repo owned by {owner} labeled {labels}.
        slots:
          owner: query.owner
          labels: query.labels
      - text: Show me issues across all repos that are assigned to me and updated since {since}.
        slots:
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's issues
      effect: read
      questions:
      - What issues are currently open in a single repository?
      - Can I filter one repo's issues by label, milestone or who created them?
      - Is it possible to list only pull requests or only issues within one repository?
      instructions:
      - text: List the open issues in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: List closed issues in {owner}/{repo} under milestone {milestones}.
        slots:
          owner: path.owner
          repo: path.repo
          milestones: query.milestones
      - text: Show issues in {owner}/{repo} created by {created_by}.
        slots:
          owner: path.owner
          repo: path.repo
          created_by: query.created_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues'].post
  update:
    x-apievangelist-phrasing:
      intent: Open a new issue in a repository
      effect: write
      questions:
      - How do I open a new issue in a Gitea repo?
      - Can I assign people, labels and a milestone while filing an issue?
      - Does the due date on a new issue keep the time of day?
      instructions:
      - text: Open an issue in {owner}/{repo} titled {title}.
        slots:
          owner: path.owner
          repo: path.repo
          title: requestBody.title
      - text: File a bug in {owner}/{repo} called {title} with details {body} and assign it to {assignees}.
        slots:
          owner: path.owner
          repo: path.repo
          title: requestBody.title
          body: requestBody.body
          assignees: requestBody.assignees
      - text: Create issue {title} in {owner}/{repo} due on {due_date}.
        slots:
          owner: path.owner
          repo: path.repo
          title: requestBody.title
          due_date: requestBody.due_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments'].get
  update:
    x-apievangelist-phrasing:
      intent: List all issue comments in a repository
      effect: read
      questions:
      - Can I pull every issue comment posted anywhere in a repository?
      - What comments were left across a repo's issues since last week?
      instructions:
      - text: List every issue comment in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Show all comments posted across {owner}/{repo} issues since {since}.
        slots:
          owner: path.owner
          repo: path.repo
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single issue comment
      effect: read
      questions:
      - How can I fetch one specific issue comment by its ID?
      - Who wrote a particular comment and what does it say?
      instructions:
      - text: Get comment {id} in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      - text: Show me the text and author of comment {id} in {repo} owned by {owner}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an issue comment by its ID
      effect: destructive
      questions:
      - Can I delete an issue comment using just the repo and comment ID?
      - How do I remove an inappropriate comment from an issue?
      instructions:
      - text: Delete comment {id} in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      - text: Remove the comment with ID {id} from the {repo} repository of {owner}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit the text of an issue comment
      effect: write
      questions:
      - Can I change the wording of a comment I already posted on an issue?
      - Is it possible to fix a typo in an existing issue comment via the API?
      instructions:
      - text: Change comment {id} in {owner}/{repo} to say {body}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
          body: requestBody.body
      - text: Rewrite the body of comment {id} in {owner}/{repo} as {body}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/assets'].get
  update:
    x-apievangelist-phrasing:
      intent: List files attached to an issue comment
      effect: read
      questions:
      - Which files are attached to a particular issue comment?
      - Can I see the attachments someone uploaded on a comment?
      instructions:
      - text: List the attachments on comment {id} in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      - text: Show files uploaded to comment {id} of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a file to an issue comment
      effect: write
      questions:
      - Can I attach a screenshot or log file to an issue comment?
      - Is there a way to set the file name when uploading to a comment?
      instructions:
      - text: Attach {attachment} to comment {id} in {owner}/{repo}.
        slots:
          attachment: requestBody.attachment
          owner: path.owner
          repo: path.repo
          id: path.id
      - text: Upload {attachment} to comment {id} in {owner}/{repo} named {name}.
        slots:
          attachment: requestBody.attachment
          owner: path.owner
          repo: path.repo
          id: path.id
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attachment on an issue comment
      effect: read
      questions:
      - How can I look up details of a single file attached to a comment?
      - Where do I find the download link for a comment attachment?
      instructions:
      - text: Get attachment {attachment_id} on comment {id} in {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Show the download URL for comment {id}'s attachment {attachment_id} in {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file attached to an issue comment
      effect: destructive
      questions:
      - Can I remove a file I uploaded to an issue comment by mistake?
      - How do I delete an attachment from a comment without deleting the comment?
      instructions:
      - text: Delete attachment {attachment_id} from comment {id} in {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      - text: Remove the file {attachment_id} attached to comment {id} of {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a file attached to an issue comment
      effect: write
      questions:
      - Can I rename an attachment that's on an issue comment?
      - Is it possible to change the displayed name of a comment's uploaded file?
      instructions:
      - text: Rename attachment {attachment_id} on comment {id} in {owner}/{repo} to {name}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      - text: Change the name of comment {id}'s file {attachment_id} in {owner}/{repo} to {name}.
        slots:
          attachment_id: path.attachment_id
          id: path.id
          owner: path.owner
          repo: path.repo
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/reactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List reactions on an issue comment
      effect: read
      questions:
      - Who reacted to a specific issue comment and with which emoji?
      - Can I see the thumbs-up count on a comment?
      instructions:
      - text: List reactions on comment {id} in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      - text: Show who reacted to comment {id} of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/reactions'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an emoji reaction to an issue comment
      effect: write
      questions:
      - Can I react to someone's issue comment with an emoji?
      - How would I give a comment a thumbs up through the API?
      instructions:
      - text: React with {content} to comment {id} in {owner}/{repo}.
        slots:
          content: requestBody.content
          owner: path.owner
          repo: path.repo
          id: path.id
      - text: Add a {content} reaction on comment {id} in the {repo} repo of {owner}.
        slots:
          content: requestBody.content
          owner: path.owner
          repo: path.repo
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/comments/{id}/reactions'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove my reaction from an issue comment
      effect: destructive
      questions:
      - Can I take back an emoji reaction I left on a comment?
      - How do I undo a reaction on an issue comment?
      instructions:
      - text: Remove my {content} reaction from comment {id} in {owner}/{repo}.
        slots:
          content: requestBody.content
          owner: path.owner
          repo: path.repo
          id: path.id
      - text: Take the {content} reaction off comment {id} of {owner}/{repo}.
        slots:
          content: requestBody.content
          owner: path.owner
          repo: path.repo
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an issue's details
      effect: read
      questions:
      - How can I look up a single issue by its number?
      - What is the current state, assignee and milestone of a given issue?
      instructions:
      - text: 'Get issue #{index} in {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Show me the details of issue {index} in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete an issue
      effect: destructive
      questions:
      - Can an issue be deleted entirely rather than just closed?
      - How do I get rid of a spam issue in my repo?
      instructions:
      - text: 'Delete issue #{index} from {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Permanently remove issue {index} in the {repo} repository of {owner}.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an issue's title, body, state or assignees
      effect: write
      questions:
      - How do I close or reopen an issue?
      - Can I change an issue's title, assignees or milestone after filing it?
      - Is there optimistic locking to avoid overwriting someone else's edit to an issue body?
      instructions:
      - text: 'Close issue #{index} in {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Rename issue {index} in {owner}/{repo} to {title}.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
          title: requestBody.title
      - text: Reassign issue {index} in {owner}/{repo} to {assignees} and move it to milestone {milestone}.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
          assignees: requestBody.assignees
          milestone: requestBody.milestone
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/assets'].get
  update:
    x-apievangelist-phrasing:
      intent: List files attached to an issue
      effect: read
      questions:
      - Which files have been attached directly to an issue?
      - Can I get the list of uploads on an issue's description?
      instructions:
      - text: 'List the attachments on issue #{index} in {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Show all files uploaded to issue {index} of {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a file to an issue
      effect: write
      questions:
      - Can I attach a file directly to an issue rather than a comment?
      - How do I upload a screenshot to an existing issue?
      instructions:
      - text: 'Attach {attachment} to issue #{index} in {owner}/{repo}.'
        slots:
          attachment: requestBody.attachment
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Upload {attachment} to issue {index} of {owner}/{repo} with file name {name}.
        slots:
          attachment: requestBody.attachment
          owner: path.owner
          repo: path.repo
          index: path.index
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attachment on an issue
      effect: read
      questions:
      - Where can I find the details of a single file attached to an issue?
      - Can I get the size and download link of an issue attachment?
      instructions:
      - text: 'Get attachment {attachment_id} on issue #{index} in {owner}/{repo}.'
        slots:
          attachment_id: path.attachment_id
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Show the download link for issue {index}'s attachment {attachment_id} in {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file attached to an issue
      effect: destructive
      questions:
      - Can I remove a file that was uploaded to an issue?
      - What happens if I delete an issue's attachment, and is the issue itself kept?
      instructions:
      - text: 'Delete attachment {attachment_id} from issue #{index} in {owner}/{repo}.'
        slots:
          attachment_id: path.attachment_id
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Remove file {attachment_id} from issue {index} of {owner}/{repo}.
        slots:
          attachment_id: path.attachment_id
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a file attached to an issue
      effect: write
      questions:
      - Is it possible to rename a file attached to an issue?
      - Can I correct the name of an upload on an issue after the fact?
      instructions:
      - text: 'Rename attachment {attachment_id} on issue #{index} in {owner}/{repo} to {name}.'
        slots:
          attachment_id: path.attachment_id
          owner: path.owner
          repo: path.repo
          index: path.index
          name: requestBody.name
      - text: Change the file name of issue {index}'s attachment {attachment_id} in {owner}/{repo} to {name}.
        slots:
          attachment_id: path.attachment_id
          owner: path.owner
          repo: path.repo
          index: path.index
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/blocks'].get
  update:
    x-apievangelist-phrasing:
      intent: List issues blocked by an issue
      effect: read
      questions:
      - Which issues are waiting on this issue to be resolved?
      - Can I see everything a given issue is blocking?
      instructions:
      - text: 'List the issues blocked by #{index} in {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Show what issue {index} in {owner}/{repo} is holding up.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/blocks'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark an issue as blocking another issue
      effect: write
      questions:
      - Can I record that one issue blocks another one?
      - Is it possible to mark an issue in a different repo as blocked by mine?
      instructions:
      - text: 'Make issue #{index} in {owner}/{repo} block issue #{blocked_index}.'
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          blocked_index: requestBody.index
      - text: Mark issue {blocked_index} in {blocked_owner}/{blocked_repo} as blocked by issue {index} of {owner}/{repo}.
        slots:
          blocked_index: requestBody.index
          blocked_owner: requestBody.owner
          blocked_repo: requestBody.repo
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/blocks'].delete
  update:
    x-apievangelist-phrasing:
      intent: Stop an issue from blocking another issue
      effect: destructive
      questions:
      - How do I unblock an issue that my issue was marked as blocking?
      - Can I remove a blocking link between two issues?
      instructions:
      - text: 'Unblock issue #{blocked_index} so it is no longer blocked by #{index} in {owner}/{repo}.'
        slots:
          blocked_index: requestBody.index
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Remove the block that issue {index} of {owner}/{repo} places on {blocked_owner}/{blocked_repo} issue {blocked_index}.
        slots:
          blocked_index: requestBody.index
          blocked_owner: requestBody.owner
          blocked_repo: requestBody.repo
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/comments'].get
  update:
    x-apievangelist-phrasing:
      intent: List the comments on one issue
      effect: read
      questions:
      - What has been said in the comment thread of a particular issue?
      - Can I get only the comments on an issue posted after a certain date?
      instructions:
      - text: 'List the comments on issue #{index} in {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Show comments on issue {index} of {owner}/{repo} posted since {since}.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/comments'].post
  update:
    x-apievangelist-phrasing:
      intent: Comment on an issue
      effect: write
      questions:
      - How do I reply to an issue with a comment?
      - Can an agent post a status update comment on an issue for me?
      instructions:
      - text: 'Comment {body} on issue #{index} in {owner}/{repo}.'
        slots:
          body: requestBody.body
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Post a reply to issue {index} in {owner}/{repo} saying {body}.
        slots:
          body: requestBody.body
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/comments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a comment via the legacy issue-scoped path
      effect: destructive
      questions:
      - Is there an older endpoint that deletes a comment by issue number and comment ID together?
      - Does the deprecated issue-scoped comment delete still work?
      instructions:
      - text: 'Using the deprecated issue-scoped endpoint, delete comment {id} on issue #{index} in {owner}/{repo}.'
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      - text: Delete comment {id} under issue {index} of {owner}/{repo} through the legacy path.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/comments/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a comment via the legacy issue-scoped path
      effect: write
      questions:
      - Is there a deprecated endpoint to edit a comment addressed by issue number and comment ID?
      - Can old integrations still edit comments through the issue-scoped legacy path?
      instructions:
      - text: 'Using the deprecated issue-scoped endpoint, change comment {id} on issue #{index} in {owner}/{repo} to {body}.'
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
          body: requestBody.body
      - text: Edit comment {id} under issue {index} of {owner}/{repo} through the legacy path to read {body}.
        slots:
          id: path.id
          index: path.index
          owner: path.owner
          repo: path.repo
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/deadline'].post
  update:
    x-apievangelist-phrasing:
      intent: Set or clear an issue's deadline
      effect: write
      questions:
      - Can I set just the due date on an issue without editing anything else?
      - How do I remove the deadline from an issue?
      - Does an issue deadline respect the time of day or only the date?
      instructions:
      - text: 'Set the deadline of issue #{index} in {owner}/{repo} to {due_date}.'
        slots:
          due_date: requestBody.due_date
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Clear the deadline on issue {index} in {owner}/{repo} by setting it to {due_date}.
        slots:
          due_date: requestBody.due_date
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/dependencies'].get
  update:
    x-apievangelist-phrasing:
      intent: List the issues blocking an issue
      effect: read
      questions:
      - Which issues must be resolved before this one can move forward?
      - What are the dependencies of a given issue?
      instructions:
      - text: 'List the dependencies of issue #{index} in {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Show which issues are blocking issue {index} in {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/dependencies'].post
  update:
    x-apievangelist-phrasing:
      intent: Make an issue depend on another issue
      effect: write
      questions:
      - Can I say that my issue depends on another issue being done first?
      - Is it possible to add a dependency on an issue in another repository?
      instructions:
      - text: 'Make issue #{index} in {owner}/{repo} depend on issue #{dep_index}.'
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          dep_index: requestBody.index
      - text: Add a dependency so issue {index} of {owner}/{repo} waits on {dep_owner}/{dep_repo} issue {dep_index}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          dep_index: requestBody.index
          dep_owner: requestBody.owner
          dep_repo: requestBody.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/dependencies'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a dependency from an issue
      effect: destructive
      questions:
      - How do I drop a dependency that's no longer relevant from an issue?
      - Can I stop an issue from depending on another one?
      instructions:
      - text: 'Remove issue #{dep_index} from the dependencies of #{index} in {owner}/{repo}.'
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          dep_index: requestBody.index
      - text: Drop the dependency of issue {index} in {owner}/{repo} on {dep_owner}/{dep_repo} issue {dep_index}.
        slots:
          index: path.index
          owner: path.owner
          repo: path.repo
          dep_index: requestBody.index
          dep_owner: requestBody.owner
          dep_repo: requestBody.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the labels on an issue
      effect: read
      questions:
      - Which labels are applied to a particular issue?
      - Is a given issue tagged as a bug or not?
      instructions:
      - text: 'Show the labels on issue #{index} in {owner}/{repo}.'
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: List what labels issue {index} of {owner}/{repo} currently has.
        slots:
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/labels'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all labels on an issue
      effect: write
      questions:
      - Can I overwrite an issue's labels with a completely new set?
      - Is there a way to swap every label on an issue in one call?
      instructions:
      - text: 'Replace the labels on issue #{index} in {owner}/{repo} with {labels}.'
        slots:
          labels: requestBody.labels
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Set issue {index} of {owner}/{repo} to have exactly the labels {labels}.
        slots:
          labels: requestBody.labels
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'
- target: $.paths['/repos/{owner}/{repo}/issues/{index}/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Add labels to an issue
      effect: write
      questions:
      - How do I tag an issue with an extra label while keeping its existing ones?
      - Can I add several labels to an issue at once?
      instructions:
      - text: 'Add label {labels} to issue #{index} in {owner}/{repo}.'
        slots:
          labels: requestBody.labels
          owner: path.owner
          repo: path.repo
          index: path.index
      - text: Tag issue {index} of {owner}/{repo} with {labels} on top of its current labels.
        slots:
          labels: requestBody.labels
          owner: path.owner
          repo: path.repo
          index: path.index
      method: generated
      generated: '2026-09-26'


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