# Bug Reports
The bug 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.
/bugs
Minimal role: Public
List bug tickets
Render the bug board from Gitea, paginated and filterable by state.
/bugs/create
Minimal role: Member
Report a bug
Enqueue a bug report. It is enhanced by AI and filed on the tracker.
/bugs/jobs/{uid}
Minimal role: Public
Bug filing job status
Poll the filing job; the result carries the new bug number and url.
/bugs/{number}
Minimal role: Public
View a bug ticket
Render a Gitea issue and its comments. Returns an HTML page.
/bugs/{number}/comment
Minimal role: Member
Comment on a bug
Post a comment to the Gitea issue, attributed to the current user.
/bugs/{number}/status
Minimal role: Admin
Change a bug status
Open or close the Gitea issue. Admin only.