issue

Search for issues across the repositories that the user has access to

Changed on
get/repos/issues/search

Request

  • Base URL
    https://demo.gitea.com/api/v1
  • Auth
    • HTTP basic
    • or API key in query parameter token
    • or API key in query parameter access_token
    • or API key in header Authorization
    • or API key in query parameter sudo
    • or API key in header Sudo
    • or API key in header X-GITEA-OTP
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

state'open' | 'closed' | 'all'

State of the issue

labelsstring

Comma-separated list of label names. Fetch only issues that have any of these labels. Non existent labels are discarded.

milestonesstring

Comma-separated list of milestone names. Fetch only issues that have any of these milestones. Non existent milestones are discarded.

qstring

Search string

type'issues' | 'pulls'

Filter by issue type

sincestring date-time

Only show issues updated after the given time (RFC 3339 format)

beforestring date-time

Only show issues updated before the given time (RFC 3339 format)

assignedboolean

Filter issues or pulls assigned to the authenticated user

createdboolean

Filter issues or pulls created by the authenticated user

mentionedboolean

Filter issues or pulls mentioning the authenticated user

review_requestedboolean

Filter pull requests where the authenticated user's review was requested

reviewedboolean

Filter pull requests reviewed by the authenticated user

ownerstring

Filter by repository owner

created_bystring

Only show items which were created by the given user

teamstring

Filter by team (requires organization owner parameter)

pageinteger

Page number of results to return (1-based)

limitinteger

Number of items per page

Response

IssueList

bodystring
closed_atstring date-time
commentsinteger
content_versioninteger

The version of the issue content for optimistic locking

created_atstring date-time
due_datestring date-time
html_urlstring
idinteger
is_lockedboolean
numberinteger
pin_orderinteger
refstring
state'open' | 'closed'
time_estimateinteger
titlestring
updated_atstring date-time
urlstring

Example response

[
  {
    "labels": [
      {
        "color": "00aabb"
      }
    ]
  }
]

Changes

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • warning

      deleted the query request parameter priority_repo_id

    • info

      added the new optional query request parameter created_by