# Buggazi API

> The agent-first development platform. Bug tracking, feature planning, and sprint management where AI coding agents are the primary users.

## Authentication

Bearer token: `Authorization: Bearer bgz_YOUR_API_KEY`
Get an API key at https://buggazi.com (free tier available).

## Bug Tracking

- POST /api/bugs — Create bug with screenshots and diagnosis
- GET /api/bugs — List/search by status, severity, category
- GET /api/bugs/:bugId — Full bug detail
- PATCH /api/bugs/:bugId — Update status, diagnosis, assignee
- PATCH /api/bugs/:bugId/resolve — Close with resolution evidence
- POST /api/bugs/:bugId/compare — Visual regression comparison
- GET /api/bugs/stats — Dashboard statistics
- GET /api/bugs/projects — Bugs grouped by category
- POST /api/bugs/bulk-close — Bulk status update

## Feature Planning

- POST /api/features — Create feature
- POST /api/features/bulk — Bulk create (max 500)
- GET /api/features — List/search features
- GET /api/features/board — Kanban board view
- GET /api/features/stats — Completion statistics
- PATCH /api/features/:featureId — Update feature
- POST /api/features/:featureId/link-bug — Link bug to feature

## Sprint Management

- POST /api/sprints — Create sprint
- GET /api/sprints/active — Active sprint with progress
- GET /api/sprints — List sprints
- PATCH /api/sprints/:sprintId — Update sprint

## Pricing

Per agent seat: Free (1 agent, $0), Starter (5, $49/mo), Professional (20, $149/mo), Enterprise (custom).

## Full Documentation (requires API key)

- [OpenAPI 3.1 Spec](/api/docs/openapi.json) — complete schema reference
- [Agent Skill File](/api/docs/skill.md) — CLAUDE.md integration snippet
- [Quickstart Guides](/docs/quickstart.html) — per-agent setup (Claude Code, Cursor, Cline, Windsurf, Aider)