# Issue Reports
The issue tracker is a full integration with a Gitea repository. The listing and detail views read
issues straight from Gitea with their live status, and a report you file is first rewritten by the
internal AI service into a consistent ticket, then posted to Gitea as an issue. The original
reporter is notified when a developer replies or the status changes, and a comment posted here is
pushed to Gitea and attributed to your account.
Every endpoint follows the shared [Conventions & Errors](/docs/conventions.html) (auth, content
negotiation, pagination, status codes); see [Authentication](/docs/authentication.html) for the
four ways to sign requests.
/issues
Minimal role: Public
List issue tickets
Render the issue board from Gitea, paginated and filterable by state.
/issues/create
Minimal role: Member
Report an issue
Enqueue an issue report. It is enhanced by AI and filed on the tracker.
/issues/jobs/{uid}
Minimal role: Public
Issue filing job status
Poll the filing job; the result carries the new issue number and url.
/issues/{number}
Minimal role: Public
View an issue ticket
Render a Gitea issue and its comments. Returns an HTML page.
/issues/{number}/comment
Minimal role: Member
Comment on an issue
Post a comment to the Gitea issue, attributed to the current user.
/issues/{number}/status
Minimal role: Admin
Change an issue status
Open or close the Gitea issue. Admin only.