# 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.
GET /bugs Minimal role: Public

List bug tickets

Render the bug board from Gitea, paginated and filterable by state.

POST /bugs/create Minimal role: Member

Report a bug

Enqueue a bug report. It is enhanced by AI and filed on the tracker.

GET /bugs/jobs/{uid} Minimal role: Public

Bug filing job status

Poll the filing job; the result carries the new bug number and url.

GET /bugs/{number} Minimal role: Public

View a bug ticket

Render a Gitea issue and its comments. Returns an HTML page.

POST /bugs/{number}/comment Minimal role: Member

Comment on a bug

Post a comment to the Gitea issue, attributed to the current user.

POST /bugs/{number}/status Minimal role: Admin

Change a bug status

Open or close the Gitea issue. Admin only.