# 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' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/labels'].delete update: x-apievangelist-phrasing: intent: Remove all labels from an issue effect: destructive questions: - Can I strip every label off an issue in one go? - What's the quickest way to clear all of an issue's labels? instructions: - text: 'Clear all labels from issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Strip every label off 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}/labels/{id}'].delete update: x-apievangelist-phrasing: intent: Remove one label from an issue effect: destructive questions: - How do I take a single label off an issue and leave the rest? - Can I untag an issue from just one label? instructions: - text: 'Remove label {id} from issue #{index} in {owner}/{repo}.' slots: id: path.id owner: path.owner repo: path.repo index: path.index - text: Untag issue {index} of {owner}/{repo} from label {id} only. slots: id: path.id owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/lock'].put update: x-apievangelist-phrasing: intent: Lock an issue's conversation effect: write questions: - Can I lock a heated issue so no more comments can be added? - Is it possible to give a reason such as spam or off-topic when locking an issue? instructions: - text: 'Lock issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Lock the conversation on issue {index} in {owner}/{repo} with reason {lock_reason}. slots: lock_reason: requestBody.lock_reason owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/lock'].delete update: x-apievangelist-phrasing: intent: Unlock an issue's conversation effect: destructive questions: - How do I reopen commenting on an issue that was locked? - Can a locked issue be unlocked through the API? instructions: - text: 'Unlock issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Allow comments again on locked 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}/pin'].post update: x-apievangelist-phrasing: intent: Pin an issue to the top of the repo effect: write questions: - Can I pin an important issue so it shows at the top of the issue list? - How would I highlight a known-issues thread by pinning it? instructions: - text: 'Pin issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Pin issue {index} to the top of {owner}/{repo}'s issues. slots: owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/pin'].delete update: x-apievangelist-phrasing: intent: Unpin an issue effect: destructive questions: - How do I unpin an issue that no longer needs to be highlighted? - Can I remove an issue from the pinned list? instructions: - text: 'Unpin issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Take issue {index} of {owner}/{repo} off the pinned list. slots: owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/pin/{position}'].patch update: x-apievangelist-phrasing: intent: Reorder a pinned issue effect: write questions: - Can I change the order of pinned issues? - Is there a way to move a pinned issue to the first position? instructions: - text: 'Move pinned issue #{index} in {owner}/{repo} to position {position}.' slots: position: path.position owner: path.owner repo: path.repo index: path.index - text: Reorder the pins in {owner}/{repo} so issue {index} sits at slot {position}. slots: position: path.position owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/reactions'].get update: x-apievangelist-phrasing: intent: List reactions on an issue effect: read questions: - How many people upvoted an issue with a reaction? - Which emoji reactions has an issue itself received? instructions: - text: 'List reactions on issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Show who reacted 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}/reactions'].post update: x-apievangelist-phrasing: intent: Add an emoji reaction to an issue effect: write questions: - Can I upvote an issue with a thumbs-up reaction? - Is reacting to an issue itself (not a comment) supported? instructions: - text: 'React with {content} to issue #{index} in {owner}/{repo}.' slots: content: requestBody.content owner: path.owner repo: path.repo index: path.index - text: Add a {content} reaction to issue {index} of {owner}/{repo}. slots: content: requestBody.content owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/reactions'].delete update: x-apievangelist-phrasing: intent: Remove my reaction from an issue effect: destructive questions: - Can I withdraw a reaction I put on an issue? - How do I remove my heart reaction from an issue? instructions: - text: 'Remove my {content} reaction from issue #{index} in {owner}/{repo}.' slots: content: requestBody.content owner: path.owner repo: path.repo index: path.index - text: Take the {content} reaction off issue {index} of {owner}/{repo}. slots: content: requestBody.content owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/stopwatch/delete'].delete update: x-apievangelist-phrasing: intent: Discard a running stopwatch on an issue effect: destructive questions: - Can I cancel an issue stopwatch without logging the time? - What if I started a timer on the wrong issue and want to throw it away? instructions: - text: 'Discard the running stopwatch on issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Cancel my timer on issue {index} of {owner}/{repo} without recording time. slots: owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/stopwatch/start'].post update: x-apievangelist-phrasing: intent: Start a time-tracking stopwatch on an issue effect: write questions: - Can I start a timer to track how long I spend on an issue? - How do I begin time tracking on an issue? instructions: - text: 'Start the stopwatch on issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Begin tracking my time on 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}/stopwatch/stop'].post update: x-apievangelist-phrasing: intent: Stop an issue stopwatch and log the time effect: write questions: - When I stop an issue timer, is the elapsed time recorded? - How can I stop the stopwatch I started on an issue? instructions: - text: 'Stop the stopwatch on issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: End my running timer on issue {index} of {owner}/{repo} and log it. slots: owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/subscriptions'].get update: x-apievangelist-phrasing: intent: List users subscribed to an issue effect: read questions: - Who is watching an issue and getting notified about it? - Can I see the subscribers of a particular issue? instructions: - text: 'List the subscribers of issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Show everyone following 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}/subscriptions/check'].get update: x-apievangelist-phrasing: intent: Check if I'm subscribed to an issue effect: read questions: - Am I currently subscribed to notifications for an issue? - Will I be notified when a particular issue changes? instructions: - text: 'Check whether I''m subscribed to issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Tell me if I'm watching 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}/subscriptions/{user}'].put update: x-apievangelist-phrasing: intent: Subscribe a user to an issue effect: write questions: - Can I subscribe a teammate to notifications on an issue? - How do I start watching an issue? instructions: - text: 'Subscribe {user} to issue #{index} in {owner}/{repo}.' slots: user: path.user owner: path.owner repo: path.repo index: path.index - text: Have {user} get notifications for issue {index} of {owner}/{repo}. slots: user: path.user owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/subscriptions/{user}'].delete update: x-apievangelist-phrasing: intent: Unsubscribe a user from an issue effect: destructive questions: - How do I stop getting notifications about an issue? - Can I unsubscribe a user from an issue they're watching? instructions: - text: 'Unsubscribe {user} from issue #{index} in {owner}/{repo}.' slots: user: path.user owner: path.owner repo: path.repo index: path.index - text: Stop notifications to {user} for issue {index} of {owner}/{repo}. slots: user: path.user owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/timeline'].get update: x-apievangelist-phrasing: intent: Get an issue's full timeline of comments and events effect: read questions: - Can I see the full history of an issue, including label changes and state events alongside comments? - What happened on an issue over a date range, events included? instructions: - text: 'Show the full timeline of issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: List all comments and events on issue {index} of {owner}/{repo} 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}/times'].get update: x-apievangelist-phrasing: intent: List time tracked on an issue effect: read questions: - How much time has been logged against an issue? - Can I see a specific user's tracked time on one issue? instructions: - text: 'List the tracked times on issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Show time {user} logged on issue {index} of {owner}/{repo}. slots: user: query.user owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/times'].post update: x-apievangelist-phrasing: intent: Log time spent on an issue effect: write questions: - Can I manually log hours worked on an issue without using the stopwatch? - Is it possible to record time on an issue on behalf of another user? instructions: - text: 'Log {time} seconds of work on issue #{index} in {owner}/{repo}.' slots: time: requestBody.time owner: path.owner repo: path.repo index: path.index - text: Add {time} seconds of tracked time for {user_name} on issue {index} of {owner}/{repo}. slots: time: requestBody.time user_name: requestBody.user_name owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/issues/{index}/times'].delete update: x-apievangelist-phrasing: intent: Reset all tracked time on an issue effect: destructive questions: - Can I wipe out all the time logged on an issue and start over? - Is there a way to zero an issue's tracked time? instructions: - text: 'Reset the tracked time on issue #{index} in {owner}/{repo}.' slots: owner: path.owner repo: path.repo index: path.index - text: Clear all logged hours from 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}/times/{id}'].delete update: x-apievangelist-phrasing: intent: Delete one tracked time entry on an issue effect: destructive questions: - How do I delete a single wrong time entry from an issue? - Can I remove one logged time record and keep the others? instructions: - text: 'Delete tracked time entry {id} on issue #{index} in {owner}/{repo}.' slots: id: path.id owner: path.owner repo: path.repo index: path.index - text: Remove the time record {id} from issue {index} of {owner}/{repo}. slots: id: path.id owner: path.owner repo: path.repo index: path.index method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/labels'].get update: x-apievangelist-phrasing: intent: List a repository's labels effect: read questions: - What labels are defined in a repository? - Which label names can I use when tagging issues in a repo? instructions: - text: List all labels in {owner}/{repo}. slots: owner: path.owner repo: path.repo - text: Show the label set available in the {repo} repository of {owner}. slots: owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/labels'].post update: x-apievangelist-phrasing: intent: Create a label in a repository effect: write questions: - How do I add a new label with a custom color to a repo? - Can I make a repository label exclusive so only one from its scope applies? instructions: - text: Create label {name} with color {color} in {owner}/{repo}. slots: name: requestBody.name color: requestBody.color owner: path.owner repo: path.repo - text: Add a repo label {name} colored {color} described as {description} to {owner}/{repo}. slots: name: requestBody.name color: requestBody.color description: requestBody.description owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/labels/{id}'].get update: x-apievangelist-phrasing: intent: Get a repository label effect: read questions: - What color and description does a particular repo label have? - Can I look up one repository label by its ID? instructions: - text: Get label {id} in {owner}/{repo}. slots: id: path.id owner: path.owner repo: path.repo - text: Show the details of repository label {id} in {owner}/{repo}. slots: id: path.id owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/labels/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a label from a repository effect: destructive questions: - Can I delete a label from a repo entirely, not just from one issue? - How do I clean up unused labels in a repository? instructions: - text: Delete label {id} from {owner}/{repo}. slots: id: path.id owner: path.owner repo: path.repo - text: Remove repository label {id} from the {repo} repo of {owner} entirely. slots: id: path.id owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/labels/{id}'].patch update: x-apievangelist-phrasing: intent: Update a repository label effect: write questions: - Can I rename or recolor an existing repo label? - Is it possible to archive a repository label? instructions: - text: Rename label {id} in {owner}/{repo} to {name}. slots: id: path.id name: requestBody.name owner: path.owner repo: path.repo - text: Change the color of repository label {id} in {owner}/{repo} to {color}. slots: id: path.id color: requestBody.color owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/milestones'].get update: x-apievangelist-phrasing: intent: List a repository's milestones effect: read questions: - What milestones are open in a repository? - Can I list closed milestones or find one by name? instructions: - text: List the milestones in {owner}/{repo}. slots: owner: path.owner repo: path.repo - text: Show {state} milestones in {owner}/{repo} named {name}. slots: state: query.state name: query.name owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/milestones'].post update: x-apievangelist-phrasing: intent: Create a milestone in a repository effect: write questions: - How do I set up a release milestone with a due date? - Can I create a milestone that's already closed? instructions: - text: Create milestone {title} in {owner}/{repo}. slots: title: requestBody.title owner: path.owner repo: path.repo - text: Add a milestone {title} due {due_on} to {owner}/{repo}. slots: title: requestBody.title due_on: requestBody.due_on owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/milestones/{id}'].get update: x-apievangelist-phrasing: intent: Get a milestone's details effect: read questions: - How far along is a milestone in open versus closed issues? - When is a particular milestone due? instructions: - text: Get milestone {id} in {owner}/{repo}. slots: id: path.id owner: path.owner repo: path.repo - text: Show the progress and due date of milestone {id} in {owner}/{repo}. slots: id: path.id owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/milestones/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a milestone effect: destructive questions: - Can I delete a milestone that was created by mistake? - How do I remove an old milestone from a repo? instructions: - text: Delete milestone {id} from {owner}/{repo}. slots: id: path.id owner: path.owner repo: path.repo - text: Remove the milestone {id} in the {repo} repository of {owner}. slots: id: path.id owner: path.owner repo: path.repo method: generated generated: '2026-09-26' - target: $.paths['/repos/{owner}/{repo}/milestones/{id}'].patch update: x-apievangelist-phrasing: intent: Update a milestone effect: write questions: - Can I push back a milestone's due date? - Is closing a milestone done by updating its state? instructions: - text: Move the due date of milestone {id} in {owner}/{repo} to {due_on}. slots: id: path.id due_on: requestBody.due_on owner: path.owner repo: path.repo - text: Set milestone {id} in {owner}/{repo} to state {state}. slots: id: path.id state: requestBody.state owner: path.owner repo: path.repo method: generated generated: '2026-09-26'