# Gitea issue API

**Canonical:** https://apis.io/apis/gitea/gitea-issue-api/  
**Provider:** Gitea — https://apis.io/providers/gitea/  
**Base URL:** https://gitea.com/api/v1  
**Documentation:** https://docs.gitea.com/api/

Gitea issue API is one of 13 APIs that [Gitea](https://apis.io/providers/gitea/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 32 JSON Schema definitions. Tagged areas include Issue. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, code examples, and 32 JSON Schemas.

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

## Operations (60 of 69)

| Method | Path | Summary |
|---|---|---|
| GET | `/repos/issues/search` | Search for issues across the repositories that the user has access to |
| GET | `/repos/{owner}/{repo}/issues` | List a repository's issues |
| POST | `/repos/{owner}/{repo}/issues` | Create an issue. If using deadline only the date will be taken into account, and time of day ignored. |
| GET | `/repos/{owner}/{repo}/issues/comments` | List all comments in a repository |
| GET | `/repos/{owner}/{repo}/issues/comments/{id}` | Get a comment |
| DELETE | `/repos/{owner}/{repo}/issues/comments/{id}` | Delete a comment |
| PATCH | `/repos/{owner}/{repo}/issues/comments/{id}` | Edit a comment |
| GET | `/repos/{owner}/{repo}/issues/comments/{id}/assets` | List comment's attachments |
| POST | `/repos/{owner}/{repo}/issues/comments/{id}/assets` | Create a comment attachment |
| GET | `/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}` | Get a comment attachment |
| DELETE | `/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}` | Delete a comment attachment |
| PATCH | `/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}` | Edit a comment attachment |
| GET | `/repos/{owner}/{repo}/issues/comments/{id}/reactions` | Get a list of reactions from a comment of an issue |
| POST | `/repos/{owner}/{repo}/issues/comments/{id}/reactions` | Add a reaction to a comment of an issue |
| DELETE | `/repos/{owner}/{repo}/issues/comments/{id}/reactions` | Remove a reaction from a comment of an issue |
| GET | `/repos/{owner}/{repo}/issues/{index}` | Get an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}` | Delete an issue |
| PATCH | `/repos/{owner}/{repo}/issues/{index}` | Edit an issue. If using deadline only the date will be taken into account, and time of day ignored. |
| GET | `/repos/{owner}/{repo}/issues/{index}/assets` | List issue's attachments |
| POST | `/repos/{owner}/{repo}/issues/{index}/assets` | Create an issue attachment |
| GET | `/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}` | Get an issue attachment |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}` | Delete an issue attachment |
| PATCH | `/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}` | Edit an issue attachment |
| GET | `/repos/{owner}/{repo}/issues/{index}/blocks` | List issues that are blocked by this issue |
| POST | `/repos/{owner}/{repo}/issues/{index}/blocks` | Block the issue given in the body by the issue in path |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/blocks` | Unblock the issue given in the body by the issue in path |
| GET | `/repos/{owner}/{repo}/issues/{index}/comments` | List all comments on an issue |
| POST | `/repos/{owner}/{repo}/issues/{index}/comments` | Add a comment to an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/comments/{id}` | Delete a comment |
| PATCH | `/repos/{owner}/{repo}/issues/{index}/comments/{id}` | Edit a comment |
| POST | `/repos/{owner}/{repo}/issues/{index}/deadline` | Set an issue deadline. If set to null, the deadline is deleted. If using deadline only the date will be taken into account, and time of day ignored. |
| GET | `/repos/{owner}/{repo}/issues/{index}/dependencies` | List an issue's dependencies, i.e all issues that block this issue. |
| POST | `/repos/{owner}/{repo}/issues/{index}/dependencies` | Make the issue in the url depend on the issue in the form. |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/dependencies` | Remove an issue dependency |
| GET | `/repos/{owner}/{repo}/issues/{index}/labels` | Get an issue's labels |
| PUT | `/repos/{owner}/{repo}/issues/{index}/labels` | Replace an issue's labels |
| POST | `/repos/{owner}/{repo}/issues/{index}/labels` | Add a label to an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/labels` | Remove all labels from an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/labels/{id}` | Remove a label from an issue |
| PUT | `/repos/{owner}/{repo}/issues/{index}/lock` | Lock an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/lock` | Unlock an issue |
| POST | `/repos/{owner}/{repo}/issues/{index}/pin` | Pin an Issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/pin` | Unpin an Issue |
| PATCH | `/repos/{owner}/{repo}/issues/{index}/pin/{position}` | Moves the Pin to the given Position |
| GET | `/repos/{owner}/{repo}/issues/{index}/reactions` | Get a list reactions of an issue |
| POST | `/repos/{owner}/{repo}/issues/{index}/reactions` | Add a reaction to an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/reactions` | Remove a reaction from an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/stopwatch/delete` | Delete an issue's existing stopwatch. |
| POST | `/repos/{owner}/{repo}/issues/{index}/stopwatch/start` | Start stopwatch on an issue. |
| POST | `/repos/{owner}/{repo}/issues/{index}/stopwatch/stop` | Stop an issue's existing stopwatch. |
| GET | `/repos/{owner}/{repo}/issues/{index}/subscriptions` | Get users who subscribed on an issue. |
| GET | `/repos/{owner}/{repo}/issues/{index}/subscriptions/check` | Check if user is subscribed to an issue |
| PUT | `/repos/{owner}/{repo}/issues/{index}/subscriptions/{user}` | Subscribe user to issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/subscriptions/{user}` | Unsubscribe user from issue |
| GET | `/repos/{owner}/{repo}/issues/{index}/timeline` | List all comments and events on an issue |
| GET | `/repos/{owner}/{repo}/issues/{index}/times` | List an issue's tracked times |
| POST | `/repos/{owner}/{repo}/issues/{index}/times` | Add tracked time to a issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/times` | Reset a tracked time of an issue |
| DELETE | `/repos/{owner}/{repo}/issues/{index}/times/{id}` | Delete specific tracked time |
| GET | `/repos/{owner}/{repo}/labels` | Get all of a repository's labels |

…and 9 more operations. They are listed in full on the page.

## Machine-readable artifacts (61)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/openapi/gitea-issue-api-openapi.yml
- **Documentation** — https://docs.gitea.com/api/
- **APIReference** — https://docs.gitea.com/api/1.26/
- **Swagger** — https://demo.gitea.com/api/swagger
- **GettingStarted** — https://docs.gitea.com/development/api-usage
- **Authentication** — https://docs.gitea.com/development/oauth2-provider
- **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
- **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
- …and 21 more, listed in full on the page.

## Other Gitea APIs (12)

- [Gitea Actions API](https://apis.io/apis/gitea/gitea-actions-api/)
- [Gitea Package Registry](https://apis.io/apis/gitea/gitea-package-registry/)
- [Gitea Webhooks](https://apis.io/apis/gitea/gitea-webhooks/)
- [Gitea Cloud Management API](https://apis.io/apis/gitea/gitea-cloud-management-api/)
- [Gitea admin API](https://apis.io/apis/gitea/gitea-admin-api/)
- [Gitea miscellaneous API](https://apis.io/apis/gitea/gitea-miscellaneous-api/)
- [Gitea notification API](https://apis.io/apis/gitea/gitea-notification-api/)
- [Gitea organization API](https://apis.io/apis/gitea/gitea-organization-api/)
- [Gitea package API](https://apis.io/apis/gitea/gitea-package-api/)
- [Gitea repository API](https://apis.io/apis/gitea/gitea-repository-api/)
- [Gitea settings API](https://apis.io/apis/gitea/gitea-settings-api/)
- [Gitea user API](https://apis.io/apis/gitea/gitea-user-api/)

## Tags

Issue

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gitea/gitea-issue-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gitea/.