How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Gitea issue API

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

Gitea issue API is one of 13 APIs that Gitea publishes on the 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.

This API exposes 69 operations across 34 paths, and defines 30 schemas. It is described by OpenAPI 2.0, at version 1.27.0+dev-89-gf52b6f3315.

Requests are made against the base URL https://gitea.com/api/v1.

69 operations 34 paths 30 schemas 19 DELETE23 GET8 PATCH16 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.27.0+dev-89-gf52b6f3315
Base URL
https://gitea.com/api/v1
Authentication
API Key, API Key, basic, API Key, API Key, API Key, API Key
License
Resource Areas
1

Authentication & Security 7

Gitea issue API declares 7 security schemes for authenticating requests. An API key is passed in the query as access_token (AccessToken). An API key is passed in the header as Authorization (AuthorizationHeaderToken). It defines a basic scheme (BasicAuth). An API key is passed in the header as Sudo (SudoHeader). An API key is passed in the query as sudo (SudoParam). An API key is passed in the header as X-GITEA-OTP (TOTPHeader). An API key is passed in the query as token (Token). By default, every request must be authenticated.

  • AccessToken — This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
  • AuthorizationHeaderToken — API tokens must be prepended with "token" followed by a space.
  • SudoHeader — Sudo API request as the user provided as the key. Admin privileges are required.
  • SudoParam — Sudo API request as the user provided as the key. Admin privileges are required.
  • TOTPHeader — Must be used in combination with BasicAuth if two-factor authentication is enabled.
  • Token — This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.

Paths & Operations 69

Across 34 paths, the API surfaces 69 operations — 19 DELETE, 23 GET, 8 PATCH, 16 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

issue 69
GET
/repos/issues/search
Search for issues across the repositories that the user has access to
issueSearchIssues 17 params → 200400422
GET
/repos/{owner}/{repo}/issues
List a repository's issues
issueListIssues 14 params → 200404
POST
/repos/{owner}/{repo}/issues
Create an issue. If using deadline only the date will be taken into account, and time of day ignored.
issueCreateIssue 3 params → 201403404412422423
GET
/repos/{owner}/{repo}/issues/comments
List all comments in a repository
issueGetRepoComments 6 params → 200404
GET
/repos/{owner}/{repo}/issues/comments/{id}
Get a comment
issueGetComment 3 params → 200204403404
DELETE
/repos/{owner}/{repo}/issues/comments/{id}
Delete a comment
issueDeleteComment 3 params → 204403404
PATCH
/repos/{owner}/{repo}/issues/comments/{id}
Edit a comment
issueEditComment 4 params → 200204403404423
GET
/repos/{owner}/{repo}/issues/comments/{id}/assets
List comment's attachments
issueListIssueCommentAttachments 3 params → 200404
POST
/repos/{owner}/{repo}/issues/comments/{id}/assets
Create a comment attachment
issueCreateIssueCommentAttachment 5 params → 201400403404413422423
GET
/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}
Get a comment attachment
issueGetIssueCommentAttachment 4 params → 200404
DELETE
/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}
Delete a comment attachment
issueDeleteIssueCommentAttachment 4 params → 204404423
PATCH
/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}
Edit a comment attachment
issueEditIssueCommentAttachment 5 params → 201404422423
GET
/repos/{owner}/{repo}/issues/comments/{id}/reactions
Get a list of reactions from a comment of an issue
issueGetCommentReactions 3 params → 200403404
POST
/repos/{owner}/{repo}/issues/comments/{id}/reactions
Add a reaction to a comment of an issue
issuePostCommentReaction 4 params → 200201403404
DELETE
/repos/{owner}/{repo}/issues/comments/{id}/reactions
Remove a reaction from a comment of an issue
issueDeleteCommentReaction 4 params → 204403404
GET
/repos/{owner}/{repo}/issues/{index}
Get an issue
issueGetIssue 3 params → 200404
DELETE
/repos/{owner}/{repo}/issues/{index}
Delete an issue
issueDelete 3 params → 204403404
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.
issueEditIssue 4 params → 201403404412
GET
/repos/{owner}/{repo}/issues/{index}/assets
List issue's attachments
issueListIssueAttachments 3 params → 200404
POST
/repos/{owner}/{repo}/issues/{index}/assets
Create an issue attachment
issueCreateIssueAttachment 5 params → 201400404413422423
GET
/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}
Get an issue attachment
issueGetIssueAttachment 4 params → 200404
DELETE
/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}
Delete an issue attachment
issueDeleteIssueAttachment 4 params → 204404423
PATCH
/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}
Edit an issue attachment
issueEditIssueAttachment 5 params → 201404422423
GET
/repos/{owner}/{repo}/issues/{index}/blocks
List issues that are blocked by this issue
issueListBlocks 5 params → 200404
POST
/repos/{owner}/{repo}/issues/{index}/blocks
Block the issue given in the body by the issue in path
issueCreateIssueBlocking 4 params → 201404
DELETE
/repos/{owner}/{repo}/issues/{index}/blocks
Unblock the issue given in the body by the issue in path
issueRemoveIssueBlocking 4 params → 200404
GET
/repos/{owner}/{repo}/issues/{index}/comments
List all comments on an issue
issueGetComments 5 params → 200404
POST
/repos/{owner}/{repo}/issues/{index}/comments
Add a comment to an issue
issueCreateComment 4 params → 201403404423
DELETE
/repos/{owner}/{repo}/issues/{index}/comments/{id}deprecated
Delete a comment
issueDeleteCommentDeprecated 4 params → 204403404
PATCH
/repos/{owner}/{repo}/issues/{index}/comments/{id}deprecated
Edit a comment
issueEditCommentDeprecated 5 params → 200204403404
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.
issueEditIssueDeadline 4 params → 201403404
GET
/repos/{owner}/{repo}/issues/{index}/dependencies
List an issue's dependencies, i.e all issues that block this issue.
issueListIssueDependencies 5 params → 200404
POST
/repos/{owner}/{repo}/issues/{index}/dependencies
Make the issue in the url depend on the issue in the form.
issueCreateIssueDependencies 4 params → 201404423
DELETE
/repos/{owner}/{repo}/issues/{index}/dependencies
Remove an issue dependency
issueRemoveIssueDependencies 4 params → 200404423
GET
/repos/{owner}/{repo}/issues/{index}/labels
Get an issue's labels
issueGetLabels 3 params → 200404
PUT
/repos/{owner}/{repo}/issues/{index}/labels
Replace an issue's labels
issueReplaceLabels 4 params → 200403404
POST
/repos/{owner}/{repo}/issues/{index}/labels
Add a label to an issue
issueAddLabel 4 params → 200403404
DELETE
/repos/{owner}/{repo}/issues/{index}/labels
Remove all labels from an issue
issueClearLabels 3 params → 204403404
DELETE
/repos/{owner}/{repo}/issues/{index}/labels/{id}
Remove a label from an issue
issueRemoveLabel 4 params → 204403404422
PUT
/repos/{owner}/{repo}/issues/{index}/lock
Lock an issue
issueLockIssue 4 params → 204403404
DELETE
/repos/{owner}/{repo}/issues/{index}/lock
Unlock an issue
issueUnlockIssue 3 params → 204403404
POST
/repos/{owner}/{repo}/issues/{index}/pin
Pin an Issue
pinIssue 3 params → 204403404
DELETE
/repos/{owner}/{repo}/issues/{index}/pin
Unpin an Issue
unpinIssue 3 params → 204403404
PATCH
/repos/{owner}/{repo}/issues/{index}/pin/{position}
Moves the Pin to the given Position
moveIssuePin 4 params → 204403404
GET
/repos/{owner}/{repo}/issues/{index}/reactions
Get a list reactions of an issue
issueGetIssueReactions 5 params → 200403404
POST
/repos/{owner}/{repo}/issues/{index}/reactions
Add a reaction to an issue
issuePostIssueReaction 4 params → 200201403404
DELETE
/repos/{owner}/{repo}/issues/{index}/reactions
Remove a reaction from an issue
issueDeleteIssueReaction 4 params → 204403404
DELETE
/repos/{owner}/{repo}/issues/{index}/stopwatch/delete
Delete an issue's existing stopwatch.
issueDeleteStopWatch 3 params → 204403404409
POST
/repos/{owner}/{repo}/issues/{index}/stopwatch/start
Start stopwatch on an issue.
issueStartStopWatch 3 params → 201403404409
POST
/repos/{owner}/{repo}/issues/{index}/stopwatch/stop
Stop an issue's existing stopwatch.
issueStopStopWatch 3 params → 201403404409
GET
/repos/{owner}/{repo}/issues/{index}/subscriptions
Get users who subscribed on an issue.
issueSubscriptions 5 params → 200404
GET
/repos/{owner}/{repo}/issues/{index}/subscriptions/check
Check if user is subscribed to an issue
issueCheckSubscription 3 params → 200404
PUT
/repos/{owner}/{repo}/issues/{index}/subscriptions/{user}
Subscribe user to issue
issueAddSubscription 4 params → 200201304404
DELETE
/repos/{owner}/{repo}/issues/{index}/subscriptions/{user}
Unsubscribe user from issue
issueDeleteSubscription 4 params → 200201304404
GET
/repos/{owner}/{repo}/issues/{index}/timeline
List all comments and events on an issue
issueGetCommentsAndTimeline 7 params → 200404
GET
/repos/{owner}/{repo}/issues/{index}/times
List an issue's tracked times
issueTrackedTimes 8 params → 200404
POST
/repos/{owner}/{repo}/issues/{index}/times
Add tracked time to a issue
issueAddTime 4 params → 200400403404
DELETE
/repos/{owner}/{repo}/issues/{index}/times
Reset a tracked time of an issue
issueResetTime 3 params → 204400403404
DELETE
/repos/{owner}/{repo}/issues/{index}/times/{id}
Delete specific tracked time
issueDeleteTime 4 params → 204400403404
GET
/repos/{owner}/{repo}/labels
Get all of a repository's labels
issueListLabels 4 params → 200404
POST
/repos/{owner}/{repo}/labels
Create a label
issueCreateLabel 3 params → 201404422
GET
/repos/{owner}/{repo}/labels/{id}
Get a single label
issueGetLabel 3 params → 200404
DELETE
/repos/{owner}/{repo}/labels/{id}
Delete a label
issueDeleteLabel 3 params → 204404
PATCH
/repos/{owner}/{repo}/labels/{id}
Update a label
issueEditLabel 4 params → 200404422
GET
/repos/{owner}/{repo}/milestones
Get all of a repository's opened milestones
issueGetMilestonesList 6 params → 200404
POST
/repos/{owner}/{repo}/milestones
Create a milestone
issueCreateMilestone 3 params → 201404
GET
/repos/{owner}/{repo}/milestones/{id}
Get a milestone
issueGetMilestone 3 params → 200404
DELETE
/repos/{owner}/{repo}/milestones/{id}
Delete a milestone
issueDeleteMilestone 3 params → 204404
PATCH
/repos/{owner}/{repo}/milestones/{id}
Update a milestone
issueEditMilestone 4 params → 200404

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are TimelineComment (29 properties), Issue (27 properties), User (22 properties), Comment (11 properties). Each schema is shown below with its type and property counts.

Comment
object
Comment represents a comment on a commit or issue
11 properties
CreateLabelOption
object
CreateLabelOption options for creating a label
5 properties 2 required
RepositoryMeta
object
RepositoryMeta basic repository information
4 properties
CreateMilestoneOption
object
CreateMilestoneOption options for creating a milestone
4 properties
User
object
User represents a user
22 properties
EditLabelOption
object
EditLabelOption options for editing a label
5 properties
IssueMeta
object
IssueMeta basic issue information
3 properties
EditDeadlineOption
object
EditDeadlineOption options for creating a deadline
1 property 1 required
Issue
object
Issue represents an issue in a repository
27 properties
EditMilestoneOption
object
EditMilestoneOption options for editing a milestone
4 properties
TrackedTime
object
TrackedTime worked time for an issue / pr
7 properties
EditReactionOption
object
EditReactionOption contain the reaction type
1 property
Milestone
object
Milestone milestone is a collection of issues on one repository
10 properties
WatchInfo
object
WatchInfo represents an API watch status of one repository
6 properties
IssueLabelsOption
object
IssueLabelsOption a collection of labels
1 property
CreateIssueOption
object
CreateIssueOption options to create one issue
9 properties 1 required
Team
object
Team represents a team in an organization
9 properties
Attachment
object
Attachment a generic attachment
7 properties
PullRequestMeta
object
PullRequestMeta PR info if an issue is a PR
4 properties
IssueDeadline
object
IssueDeadline represents an issue deadline
1 property
EditIssueOption
object
EditIssueOption options for editing an issue
10 properties
TimelineComment
object
TimelineComment represents a timeline comment (comment of any type) on a commit or issue
29 properties
LockIssueOption
object
LockIssueOption options to lock an issue
1 property
AddTimeOption
object
AddTimeOption options for adding time to an issue
3 properties 1 required
Reaction
object
Reaction contain one reaction
3 properties
Organization
object
Organization represents an organization
11 properties
CreateIssueCommentOption
object
CreateIssueCommentOption options for creating a comment on an issue
1 property 1 required
Label
object
Label a label to an issue or a pr
7 properties
EditIssueCommentOption
object
EditIssueCommentOption options for editing a comment
1 property 1 required
EditAttachmentOptions
object
EditAttachmentOptions options for editing attachments
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

gitea-issue-api-openapi.yml Raw ↑

Other APIs Gitea publishes across the network.

Gitea Actions API
Gitea Package Registry
Gitea Webhooks
Gitea Cloud Management API
Gitea admin API
Gitea miscellaneous API
Gitea notification API
Gitea organization API
Gitea package API
Gitea repository API
Gitea settings API
Gitea user API
Where this information came from

This is an independent, third-party profile of Gitea issue API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.