Gitea

Gitea Issue API

The issue API from Gitea — 34 operation(s) for issue.

GitHub OpenAPI
Business capability
Software Product Engineering Management BC-4200

Operations 69

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /repos/issues/search Search issues across all my accessible repos · Search for issues across the repositories that the user has access to #
Ask an LLM
“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?”
Tell an agent
Search all my accessible repositories for issues matching {q}.
Find open issues across every repo owned by {owner} labeled {labels}.
GET /repos/{owner}/{repo}/issues List a repository's issues · List a repository's issues #
Ask an LLM
“What issues are currently open in a single repository?”
“Can I filter one repo's issues by label, milestone or who created them?”
Tell an agent
List the open issues in {owner}/{repo}.
List closed issues in {owner}/{repo} under milestone {milestones}.
POST /repos/{owner}/{repo}/issues Open a new issue in a repository · Create an issue. #
Ask an LLM
“How do I open a new issue in a Gitea repo?”
“Can I assign people, labels and a milestone while filing an issue?”
Tell an agent
Open an issue in {owner}/{repo} titled {title}.
File a bug in {owner}/{repo} called {title} with details {body} and assign it to {assignees}.
GET /repos/{owner}/{repo}/issues/comments List all issue comments in a repository · List all comments in a repository #
Ask an LLM
“Can I pull every issue comment posted anywhere in a repository?”
“What comments were left across a repo's issues since last week?”
Tell an agent
List every issue comment in {owner}/{repo}.
Show all comments posted across {owner}/{repo} issues since {since}.
GET /repos/{owner}/{repo}/issues/comments/{id} Get a single issue comment · Get a comment #
Ask an LLM
“How can I fetch one specific issue comment by its ID?”
“Who wrote a particular comment and what does it say?”
Tell an agent
Get comment {id} in {owner}/{repo}.
Show me the text and author of comment {id} in {repo} owned by {owner}.
DELETE /repos/{owner}/{repo}/issues/comments/{id} Delete an issue comment by its ID · Delete a comment #
Ask an LLM
“Can I delete an issue comment using just the repo and comment ID?”
“How do I remove an inappropriate comment from an issue?”
Tell an agent destructive · confirm first
Delete comment {id} in {owner}/{repo}.
Remove the comment with ID {id} from the {repo} repository of {owner}.
PATCH /repos/{owner}/{repo}/issues/comments/{id} Edit the text of an issue comment · Edit a comment #
Ask an LLM
“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?”
Tell an agent
Change comment {id} in {owner}/{repo} to say {body}.
Rewrite the body of comment {id} in {owner}/{repo} as {body}.
GET /repos/{owner}/{repo}/issues/comments/{id}/assets List files attached to an issue comment · List comment's attachments #
Ask an LLM
“Which files are attached to a particular issue comment?”
“Can I see the attachments someone uploaded on a comment?”
Tell an agent
List the attachments on comment {id} in {owner}/{repo}.
Show files uploaded to comment {id} of {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/comments/{id}/assets Upload a file to an issue comment · Create a comment attachment #
Ask an LLM
“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?”
Tell an agent
Attach {attachment} to comment {id} in {owner}/{repo}.
Upload {attachment} to comment {id} in {owner}/{repo} named {name}.
GET /repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id} Get one attachment on an issue comment · Get a comment attachment #
Ask an LLM
“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?”
Tell an agent
Get attachment {attachment_id} on comment {id} in {owner}/{repo}.
Show the download URL for comment {id}'s attachment {attachment_id} in {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id} Delete a file attached to an issue comment · Delete a comment attachment #
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Delete attachment {attachment_id} from comment {id} in {owner}/{repo}.
Remove the file {attachment_id} attached to comment {id} of {owner}/{repo}.
PATCH /repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id} Rename a file attached to an issue comment · Edit a comment attachment #
Ask an LLM
“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?”
Tell an agent
Rename attachment {attachment_id} on comment {id} in {owner}/{repo} to {name}.
Change the name of comment {id}'s file {attachment_id} in {owner}/{repo} to {name}.
GET /repos/{owner}/{repo}/issues/comments/{id}/reactions List reactions on an issue comment · Get a list of reactions from a comment of an issue #
Ask an LLM
“Who reacted to a specific issue comment and with which emoji?”
“Can I see the thumbs-up count on a comment?”
Tell an agent
List reactions on comment {id} in {owner}/{repo}.
Show who reacted to comment {id} of {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/comments/{id}/reactions Add an emoji reaction to an issue comment · Add a reaction to a comment of an issue #
Ask an LLM
“Can I react to someone's issue comment with an emoji?”
“How would I give a comment a thumbs up through the API?”
Tell an agent
React with {content} to comment {id} in {owner}/{repo}.
Add a {content} reaction on comment {id} in the {repo} repo of {owner}.
DELETE /repos/{owner}/{repo}/issues/comments/{id}/reactions Remove my reaction from an issue comment · Remove a reaction from a comment of an issue #
Ask an LLM
“Can I take back an emoji reaction I left on a comment?”
“How do I undo a reaction on an issue comment?”
Tell an agent destructive · confirm first
Remove my {content} reaction from comment {id} in {owner}/{repo}.
Take the {content} reaction off comment {id} of {owner}/{repo}.
GET /repos/{owner}/{repo}/issues/{index} Get an issue's details · Get an issue #
Ask an LLM
“How can I look up a single issue by its number?”
“What is the current state, assignee and milestone of a given issue?”
Tell an agent
Get issue #{index} in {owner}/{repo}.
Show me the details of issue {index} in {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index} Permanently delete an issue · Delete an issue #
Ask an LLM
“Can an issue be deleted entirely rather than just closed?”
“How do I get rid of a spam issue in my repo?”
Tell an agent destructive · confirm first
Delete issue #{index} from {owner}/{repo}.
Permanently remove issue {index} in the {repo} repository of {owner}.
PATCH /repos/{owner}/{repo}/issues/{index} Update an issue's title, body, state or assignees · Edit an issue. #
Ask an LLM
“How do I close or reopen an issue?”
“Can I change an issue's title, assignees or milestone after filing it?”
Tell an agent
Close issue #{index} in {owner}/{repo}.
Rename issue {index} in {owner}/{repo} to {title}.
GET /repos/{owner}/{repo}/issues/{index}/assets List files attached to an issue · List issue's attachments #
Ask an LLM
“Which files have been attached directly to an issue?”
“Can I get the list of uploads on an issue's description?”
Tell an agent
List the attachments on issue #{index} in {owner}/{repo}.
Show all files uploaded to issue {index} of {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/{index}/assets Upload a file to an issue · Create an issue attachment #
Ask an LLM
“Can I attach a file directly to an issue rather than a comment?”
“How do I upload a screenshot to an existing issue?”
Tell an agent
Attach {attachment} to issue #{index} in {owner}/{repo}.
Upload {attachment} to issue {index} of {owner}/{repo} with file name {name}.
GET /repos/{owner}/{repo}/issues/{index}/assets/{attachment_id} Get one attachment on an issue · Get an issue attachment #
Ask an LLM
“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?”
Tell an agent
Get attachment {attachment_id} on issue #{index} in {owner}/{repo}.
Show the download link for issue {index}'s attachment {attachment_id} in {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/assets/{attachment_id} Delete a file attached to an issue · Delete an issue attachment #
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Delete attachment {attachment_id} from issue #{index} in {owner}/{repo}.
Remove file {attachment_id} from issue {index} of {owner}/{repo}.
PATCH /repos/{owner}/{repo}/issues/{index}/assets/{attachment_id} Rename a file attached to an issue · Edit an issue attachment #
Ask an LLM
“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?”
Tell an agent
Rename attachment {attachment_id} on issue #{index} in {owner}/{repo} to {name}.
Change the file name of issue {index}'s attachment {attachment_id} in {owner}/{repo} to {name}.
GET /repos/{owner}/{repo}/issues/{index}/blocks List issues blocked by an issue · List issues that are blocked by this issue #
Ask an LLM
“Which issues are waiting on this issue to be resolved?”
“Can I see everything a given issue is blocking?”
Tell an agent
List the issues blocked by #{index} in {owner}/{repo}.
Show what issue {index} in {owner}/{repo} is holding up.
POST /repos/{owner}/{repo}/issues/{index}/blocks Mark an issue as blocking another issue · Block the issue given in the body by the issue in path #
Ask an LLM
“Can I record that one issue blocks another one?”
“Is it possible to mark an issue in a different repo as blocked by mine?”
Tell an agent
Make issue #{index} in {owner}/{repo} block issue #{blocked_index}.
Mark issue {blocked_index} in {blocked_owner}/{blocked_repo} as blocked by issue {index} of {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/blocks Stop an issue from blocking another issue · Unblock the issue given in the body by the issue in path #
Ask an LLM
“How do I unblock an issue that my issue was marked as blocking?”
“Can I remove a blocking link between two issues?”
Tell an agent destructive · confirm first
Unblock issue #{blocked_index} so it is no longer blocked by #{index} in {owner}/{repo}.
Remove the block that issue {index} of {owner}/{repo} places on {blocked_owner}/{blocked_repo} issue {blocked_index}.
GET /repos/{owner}/{repo}/issues/{index}/comments List the comments on one issue · List all comments on an issue #
Ask an LLM
“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?”
Tell an agent
List the comments on issue #{index} in {owner}/{repo}.
Show comments on issue {index} of {owner}/{repo} posted since {since}.
POST /repos/{owner}/{repo}/issues/{index}/comments Comment on an issue · Add a comment to an issue #
Ask an LLM
“How do I reply to an issue with a comment?”
“Can an agent post a status update comment on an issue for me?”
Tell an agent
Comment {body} on issue #{index} in {owner}/{repo}.
Post a reply to issue {index} in {owner}/{repo} saying {body}.
DELETE /repos/{owner}/{repo}/issues/{index}/comments/{id} Delete a comment via the legacy issue-scoped path · Delete a comment #
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Using the deprecated issue-scoped endpoint, delete comment {id} on issue #{index} in {owner}/{repo}.
Delete comment {id} under issue {index} of {owner}/{repo} through the legacy path.
PATCH /repos/{owner}/{repo}/issues/{index}/comments/{id} Edit a comment via the legacy issue-scoped path · Edit a comment #
Ask an LLM
“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?”
Tell an agent
Using the deprecated issue-scoped endpoint, change comment {id} on issue #{index} in {owner}/{repo} to {body}.
Edit comment {id} under issue {index} of {owner}/{repo} through the legacy path to read {body}.
POST /repos/{owner}/{repo}/issues/{index}/deadline Set or clear an issue's deadline · Set an issue deadline. #
Ask an LLM
“Can I set just the due date on an issue without editing anything else?”
“How do I remove the deadline from an issue?”
Tell an agent
Set the deadline of issue #{index} in {owner}/{repo} to {due_date}.
Clear the deadline on issue {index} in {owner}/{repo} by setting it to {due_date}.
GET /repos/{owner}/{repo}/issues/{index}/dependencies List the issues blocking an issue · List an issue's dependencies, i.e all issues that block this issue #
Ask an LLM
“Which issues must be resolved before this one can move forward?”
“What are the dependencies of a given issue?”
Tell an agent
List the dependencies of issue #{index} in {owner}/{repo}.
Show which issues are blocking issue {index} in {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/{index}/dependencies Make an issue depend on another issue · Make the issue in the url depend on the issue in the form #
Ask an LLM
“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?”
Tell an agent
Make issue #{index} in {owner}/{repo} depend on issue #{dep_index}.
Add a dependency so issue {index} of {owner}/{repo} waits on {dep_owner}/{dep_repo} issue {dep_index}.
DELETE /repos/{owner}/{repo}/issues/{index}/dependencies Remove a dependency from an issue · Remove an issue dependency #
Ask an LLM
“How do I drop a dependency that's no longer relevant from an issue?”
“Can I stop an issue from depending on another one?”
Tell an agent destructive · confirm first
Remove issue #{dep_index} from the dependencies of #{index} in {owner}/{repo}.
Drop the dependency of issue {index} in {owner}/{repo} on {dep_owner}/{dep_repo} issue {dep_index}.
GET /repos/{owner}/{repo}/issues/{index}/labels Get the labels on an issue · Get an issue's labels #
Ask an LLM
“Which labels are applied to a particular issue?”
“Is a given issue tagged as a bug or not?”
Tell an agent
Show the labels on issue #{index} in {owner}/{repo}.
List what labels issue {index} of {owner}/{repo} currently has.
PUT /repos/{owner}/{repo}/issues/{index}/labels Replace all labels on an issue · Replace an issue's labels #
Ask an LLM
“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?”
Tell an agent
Replace the labels on issue #{index} in {owner}/{repo} with {labels}.
Set issue {index} of {owner}/{repo} to have exactly the labels {labels}.
POST /repos/{owner}/{repo}/issues/{index}/labels Add labels to an issue · Add a label to an issue #
Ask an LLM
“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?”
Tell an agent
Add label {labels} to issue #{index} in {owner}/{repo}.
Tag issue {index} of {owner}/{repo} with {labels} on top of its current labels.
DELETE /repos/{owner}/{repo}/issues/{index}/labels Remove all labels from an issue · Remove all labels from an issue #
Ask an LLM
“Can I strip every label off an issue in one go?”
“What's the quickest way to clear all of an issue's labels?”
Tell an agent destructive · confirm first
Clear all labels from issue #{index} in {owner}/{repo}.
Strip every label off issue {index} of {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/labels/{id} Remove one label from an issue · Remove a label from an issue #
Ask an LLM
“How do I take a single label off an issue and leave the rest?”
“Can I untag an issue from just one label?”
Tell an agent destructive · confirm first
Remove label {id} from issue #{index} in {owner}/{repo}.
Untag issue {index} of {owner}/{repo} from label {id} only.
PUT /repos/{owner}/{repo}/issues/{index}/lock Lock an issue's conversation · Lock an issue #
Ask an LLM
“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?”
Tell an agent
Lock issue #{index} in {owner}/{repo}.
Lock the conversation on issue {index} in {owner}/{repo} with reason {lock_reason}.
DELETE /repos/{owner}/{repo}/issues/{index}/lock Unlock an issue's conversation · Unlock an issue #
Ask an LLM
“How do I reopen commenting on an issue that was locked?”
“Can a locked issue be unlocked through the API?”
Tell an agent destructive · confirm first
Unlock issue #{index} in {owner}/{repo}.
Allow comments again on locked issue {index} of {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/{index}/pin Pin an issue to the top of the repo · Pin an Issue #
Ask an LLM
“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?”
Tell an agent
Pin issue #{index} in {owner}/{repo}.
Pin issue {index} to the top of {owner}/{repo}'s issues.
DELETE /repos/{owner}/{repo}/issues/{index}/pin Unpin an issue · Unpin an Issue #
Ask an LLM
“How do I unpin an issue that no longer needs to be highlighted?”
“Can I remove an issue from the pinned list?”
Tell an agent destructive · confirm first
Unpin issue #{index} in {owner}/{repo}.
Take issue {index} of {owner}/{repo} off the pinned list.
PATCH /repos/{owner}/{repo}/issues/{index}/pin/{position} Reorder a pinned issue · Moves the Pin to the given Position #
Ask an LLM
“Can I change the order of pinned issues?”
“Is there a way to move a pinned issue to the first position?”
Tell an agent
Move pinned issue #{index} in {owner}/{repo} to position {position}.
Reorder the pins in {owner}/{repo} so issue {index} sits at slot {position}.
GET /repos/{owner}/{repo}/issues/{index}/reactions List reactions on an issue · Get a list reactions of an issue #
Ask an LLM
“How many people upvoted an issue with a reaction?”
“Which emoji reactions has an issue itself received?”
Tell an agent
List reactions on issue #{index} in {owner}/{repo}.
Show who reacted to issue {index} of {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/{index}/reactions Add an emoji reaction to an issue · Add a reaction to an issue #
Ask an LLM
“Can I upvote an issue with a thumbs-up reaction?”
“Is reacting to an issue itself (not a comment) supported?”
Tell an agent
React with {content} to issue #{index} in {owner}/{repo}.
Add a {content} reaction to issue {index} of {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/reactions Remove my reaction from an issue · Remove a reaction from an issue #
Ask an LLM
“Can I withdraw a reaction I put on an issue?”
“How do I remove my heart reaction from an issue?”
Tell an agent destructive · confirm first
Remove my {content} reaction from issue #{index} in {owner}/{repo}.
Take the {content} reaction off issue {index} of {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/stopwatch/delete Discard a running stopwatch on an issue · Delete an issue's existing stopwatch #
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Discard the running stopwatch on issue #{index} in {owner}/{repo}.
Cancel my timer on issue {index} of {owner}/{repo} without recording time.
POST /repos/{owner}/{repo}/issues/{index}/stopwatch/start Start a time-tracking stopwatch on an issue · Start stopwatch on an issue #
Ask an LLM
“Can I start a timer to track how long I spend on an issue?”
“How do I begin time tracking on an issue?”
Tell an agent
Start the stopwatch on issue #{index} in {owner}/{repo}.
Begin tracking my time on issue {index} of {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/{index}/stopwatch/stop Stop an issue stopwatch and log the time · Stop an issue's existing stopwatch #
Ask an LLM
“When I stop an issue timer, is the elapsed time recorded?”
“How can I stop the stopwatch I started on an issue?”
Tell an agent
Stop the stopwatch on issue #{index} in {owner}/{repo}.
End my running timer on issue {index} of {owner}/{repo} and log it.
GET /repos/{owner}/{repo}/issues/{index}/subscriptions List users subscribed to an issue · Get users who subscribed on an issue #
Ask an LLM
“Who is watching an issue and getting notified about it?”
“Can I see the subscribers of a particular issue?”
Tell an agent
List the subscribers of issue #{index} in {owner}/{repo}.
Show everyone following issue {index} of {owner}/{repo}.
GET /repos/{owner}/{repo}/issues/{index}/subscriptions/check Check if I'm subscribed to an issue · Check if user is subscribed to an issue #
Ask an LLM
“Am I currently subscribed to notifications for an issue?”
“Will I be notified when a particular issue changes?”
Tell an agent
Check whether I'm subscribed to issue #{index} in {owner}/{repo}.
Tell me if I'm watching issue {index} of {owner}/{repo}.
PUT /repos/{owner}/{repo}/issues/{index}/subscriptions/{user} Subscribe a user to an issue · Subscribe user to issue #
Ask an LLM
“Can I subscribe a teammate to notifications on an issue?”
“How do I start watching an issue?”
Tell an agent
Subscribe {user} to issue #{index} in {owner}/{repo}.
Have {user} get notifications for issue {index} of {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/subscriptions/{user} Unsubscribe a user from an issue · Unsubscribe user from issue #
Ask an LLM
“How do I stop getting notifications about an issue?”
“Can I unsubscribe a user from an issue they're watching?”
Tell an agent destructive · confirm first
Unsubscribe {user} from issue #{index} in {owner}/{repo}.
Stop notifications to {user} for issue {index} of {owner}/{repo}.
GET /repos/{owner}/{repo}/issues/{index}/timeline Get an issue's full timeline of comments and events · List all comments and events on an issue #
Ask an LLM
“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?”
Tell an agent
Show the full timeline of issue #{index} in {owner}/{repo}.
List all comments and events on issue {index} of {owner}/{repo} since {since}.
GET /repos/{owner}/{repo}/issues/{index}/times List time tracked on an issue · List an issue's tracked times #
Ask an LLM
“How much time has been logged against an issue?”
“Can I see a specific user's tracked time on one issue?”
Tell an agent
List the tracked times on issue #{index} in {owner}/{repo}.
Show time {user} logged on issue {index} of {owner}/{repo}.
POST /repos/{owner}/{repo}/issues/{index}/times Log time spent on an issue · Add tracked time to a issue #
Ask an LLM
“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?”
Tell an agent
Log {time} seconds of work on issue #{index} in {owner}/{repo}.
Add {time} seconds of tracked time for {user_name} on issue {index} of {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/times Reset all tracked time on an issue · Reset a tracked time of an issue #
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Reset the tracked time on issue #{index} in {owner}/{repo}.
Clear all logged hours from issue {index} of {owner}/{repo}.
DELETE /repos/{owner}/{repo}/issues/{index}/times/{id} Delete one tracked time entry on an issue · Delete specific tracked time #
Ask an LLM
“How do I delete a single wrong time entry from an issue?”
“Can I remove one logged time record and keep the others?”
Tell an agent destructive · confirm first
Delete tracked time entry {id} on issue #{index} in {owner}/{repo}.
Remove the time record {id} from issue {index} of {owner}/{repo}.
GET /repos/{owner}/{repo}/labels List a repository's labels · Get all of a repository's labels #
Ask an LLM
“What labels are defined in a repository?”
“Which label names can I use when tagging issues in a repo?”
Tell an agent
List all labels in {owner}/{repo}.
Show the label set available in the {repo} repository of {owner}.
POST /repos/{owner}/{repo}/labels Create a label in a repository · Create a label #
Ask an LLM
“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?”
Tell an agent
Create label {name} with color {color} in {owner}/{repo}.
Add a repo label {name} colored {color} described as {description} to {owner}/{repo}.
GET /repos/{owner}/{repo}/labels/{id} Get a repository label · Get a single label #
Ask an LLM
“What color and description does a particular repo label have?”
“Can I look up one repository label by its ID?”
Tell an agent
Get label {id} in {owner}/{repo}.
Show the details of repository label {id} in {owner}/{repo}.
DELETE /repos/{owner}/{repo}/labels/{id} Delete a label from a repository · Delete a label #
Ask an LLM
“Can I delete a label from a repo entirely, not just from one issue?”
“How do I clean up unused labels in a repository?”
Tell an agent destructive · confirm first
Delete label {id} from {owner}/{repo}.
Remove repository label {id} from the {repo} repo of {owner} entirely.
PATCH /repos/{owner}/{repo}/labels/{id} Update a repository label · Update a label #
Ask an LLM
“Can I rename or recolor an existing repo label?”
“Is it possible to archive a repository label?”
Tell an agent
Rename label {id} in {owner}/{repo} to {name}.
Change the color of repository label {id} in {owner}/{repo} to {color}.
GET /repos/{owner}/{repo}/milestones List a repository's milestones · Get all of a repository's opened milestones #
Ask an LLM
“What milestones are open in a repository?”
“Can I list closed milestones or find one by name?”
Tell an agent
List the milestones in {owner}/{repo}.
Show {state} milestones in {owner}/{repo} named {name}.
POST /repos/{owner}/{repo}/milestones Create a milestone in a repository · Create a milestone #
Ask an LLM
“How do I set up a release milestone with a due date?”
“Can I create a milestone that's already closed?”
Tell an agent
Create milestone {title} in {owner}/{repo}.
Add a milestone {title} due {due_on} to {owner}/{repo}.
GET /repos/{owner}/{repo}/milestones/{id} Get a milestone's details · Get a milestone #
Ask an LLM
“How far along is a milestone in open versus closed issues?”
“When is a particular milestone due?”
Tell an agent
Get milestone {id} in {owner}/{repo}.
Show the progress and due date of milestone {id} in {owner}/{repo}.
DELETE /repos/{owner}/{repo}/milestones/{id} Delete a milestone · Delete a milestone #
Ask an LLM
“Can I delete a milestone that was created by mistake?”
“How do I remove an old milestone from a repo?”
Tell an agent destructive · confirm first
Delete milestone {id} from {owner}/{repo}.
Remove the milestone {id} in the {repo} repository of {owner}.
PATCH /repos/{owner}/{repo}/milestones/{id} Update a milestone · Update a milestone #
Ask an LLM
“Can I push back a milestone's due date?”
“Is closing a milestone done by updating its state?”
Tell an agent
Move the due date of milestone {id} in {owner}/{repo} to {due_on}.
Set milestone {id} in {owner}/{repo} to state {state}.

Documentation

📖
Documentation
https://docs.gitea.com/api/
📖
APIReference
https://docs.gitea.com/api/1.26/
📖
GettingStarted
https://docs.gitea.com/development/api-usage
📖
Authentication
https://docs.gitea.com/development/oauth2-provider

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/openapi/gitea-issue-api-openapi.yml

Code Examples

💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-repo-get-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-repo-update-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-issues-list-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-issue-create-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-pulls-list-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-pull-create-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-branches-list-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-commits-list-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-release-create-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-webhook-create-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-org-create-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-org-repos-list-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-user-get-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-user-repo-create-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-admin-user-create-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-notifications-list-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-packages-list-owner-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-repository-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-issue-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-pullrequest-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-release-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-hook-example.json
💻
CodeExamples
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-package-example.json

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-repository-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-issue-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-pullrequest-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-branch-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-commit-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-release-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-hook-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-organization-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-team-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-user-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-notificationthread-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-package-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-label-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-milestone-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-tag-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-comment-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-repository-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-issue-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-pullrequest-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-branch-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-commit-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-release-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-hook-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-organization-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-team-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-user-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-notificationthread-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-package-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-label-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-milestone-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-tag-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-comment-structure.json

Other Resources

🔗
Swagger
https://demo.gitea.com/api/swagger

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/gitea:gitea-issue-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gitea-issue-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: This documentation describes the Gitea API.
  title: Gitea Issue API
  license:
    name: MIT
    url: http://opensource.org/licenses/MIT
  version: 1.27.0+dev-89-gf52b6f3315
servers:
- url: /api/v1
security:
- BasicAuth: []
- Token: []
- AccessToken: []
- AuthorizationHeaderToken: []
- SudoParam: []
- SudoHeader: []
- TOTPHeader: []
tags:


# --- truncated at 32 KB (105 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/openapi/gitea-issue-api-openapi.yml