Quickstart: Agent-First API

Bug tracking, feature planning, and sprint management for coding agents. Get running in 60 seconds.

export BUGGAZI_BASE_URL=https://buggazi.com
export BUGGAZI_API_KEY=bgz_your_key_here

curl -X POST ${BUGGAZI_BASE_URL}/api/bugs \
  -H "Authorization: Bearer ${BUGGAZI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Login form returns 500",
    "severity": "P1",
    "category": "myproject-auth",
    "source": "e2e-test",
    "evidence": {
      "testOutput": "AssertionError: expected 200 got 500"
    }
  }'

# Response: {"bugId":"BUG-2026-0514-001","status":"reported"}

curl ${BUGGAZI_BASE_URL}/api/bugs/stats \
  -H "Authorization: Bearer ${BUGGAZI_API_KEY}"

# Response: {"total":1,"open":1,"byStatus":{"reported":1},"bySeverity":{"P1":1}}

Create a feature

curl -X POST ${BUGGAZI_BASE_URL}/api/features \
  -H "Authorization: Bearer ${BUGGAZI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"title":"SSO support","priority":"P1","category":"myproject-auth","status":"todo"}'

Create a sprint

curl -X POST ${BUGGAZI_BASE_URL}/api/sprints \
  -H "Authorization: Bearer ${BUGGAZI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sprint 1","goal":"Ship auth module","status":"active","startDate":"2026-05-14","endDate":"2026-05-28"}'

Check sprint progress

curl ${BUGGAZI_BASE_URL}/api/sprints/active \
  -H "Authorization: Bearer ${BUGGAZI_API_KEY}"

# Returns: {sprint, progress: {total, done, inProgress, remaining, percentComplete}}

Resolve a bug

curl -X PATCH ${BUGGAZI_BASE_URL}/api/bugs/BUG-2026-0514-001/resolve \
  -H "Authorization: Bearer ${BUGGAZI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "verified",
    "resolution": {
      "fix": "Added null check in auth handler",
      "filesChanged": ["src/auth.js"],
      "commitSha": "a3f2c1d",
      "verifiedBy": "e2e-test",
      "verificationResult": "All tests pass"
    }
  }'