curl -X GET "https://nunu.ai/api/v1/project/your-project-id/bugs?status=active&severity=high&page=0&page_size=20" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/bugs?status=active&severity=high",
{ headers: { "X-Api-Key": process.env.NUNU_API_TOKEN } }
);
const data = await response.json();
import requests, os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/bugs",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"status": "active", "severity": "high", "page": 0, "page_size": 20},
)
data = response.json()
{
"data": [
{
"id": "bug_8a1b2c3d",
"project_id": "test",
"title": "Inventory icon flickers when opening menu",
"description": "When the inventory menu is opened quickly after a level transition, the inventory icon briefly flickers in and out.",
"reproduction_steps": "1. Complete a level. 2. Press the inventory button immediately after the transition.",
"severity": "medium",
"category": "ui",
"confidence": "high",
"tags": ["ui", "menu"],
"details": null,
"status": "active",
"suppress_reporting": false,
"occurrence_count": 4,
"created_at": "2026-04-01T10:00:00.000000+00:00",
"created_by": "reviewer@example.com"
}
],
"pagination": {
"page": 0,
"page_size": 20,
"total_count": 1,
"total_pages": 1
}
}
Bugs
List Reviewed Bugs
Retrieve a paginated list of reviewed bugs for your project.
GET
/
project
/
{projectId}
/
bugs
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/bugs?status=active&severity=high&page=0&page_size=20" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/bugs?status=active&severity=high",
{ headers: { "X-Api-Key": process.env.NUNU_API_TOKEN } }
);
const data = await response.json();
import requests, os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/bugs",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"status": "active", "severity": "high", "page": 0, "page_size": 20},
)
data = response.json()
{
"data": [
{
"id": "bug_8a1b2c3d",
"project_id": "test",
"title": "Inventory icon flickers when opening menu",
"description": "When the inventory menu is opened quickly after a level transition, the inventory icon briefly flickers in and out.",
"reproduction_steps": "1. Complete a level. 2. Press the inventory button immediately after the transition.",
"severity": "medium",
"category": "ui",
"confidence": "high",
"tags": ["ui", "menu"],
"details": null,
"status": "active",
"suppress_reporting": false,
"occurrence_count": 4,
"created_at": "2026-04-01T10:00:00.000000+00:00",
"created_by": "reviewer@example.com"
}
],
"pagination": {
"page": 0,
"page_size": 20,
"total_count": 1,
"total_pages": 1
}
}
Permission Required:
project:read-runsReturns
403 if the project does not have the bug_review feature enabled.Query Parameters
string
default:"active"
Filter by status:
active, archived, or allstring
Free-text search across bug title, description, and reproduction steps
string
Filter by severity:
low, medium, high, or criticalstring
Filter by bug category (e.g.,
ui, gameplay, performance)string
Field to sort by (e.g.,
created_at, severity, occurrence_count)string
Sort direction:
asc or descinteger
default:"0"
Page number (0-indexed)
integer
default:"20"
Results per page (1-100)
Response
BugSummary[]
required
Array of bug summary objects
object
required
Pagination metadata (
page, page_size, total_count, total_pages)BugSummary Object
string
required
Unique bug identifier (consistent across runs)
string
required
Project the bug belongs to
string
required
Short bug title
string
required
Detailed description of the bug
string
required
Steps to reproduce the bug
string
required
Severity level:
low, medium, high, criticalstring
required
Bug category (e.g.,
ui, gameplay, performance)string
required
Detection confidence:
low, medium, highstring[]
required
Tags assigned to the bug
object
Additional bug-specific metadata, or
nullstring
required
Bug status:
active or archivedboolean
required
Whether reporting for this bug is suppressed
integer
required
Number of times this bug has been observed across runs
string
required
ISO 8601 timestamp when the bug was first reviewed
string
Who created/reviewed the bug
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/bugs?status=active&severity=high&page=0&page_size=20" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/bugs?status=active&severity=high",
{ headers: { "X-Api-Key": process.env.NUNU_API_TOKEN } }
);
const data = await response.json();
import requests, os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/bugs",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"status": "active", "severity": "high", "page": 0, "page_size": 20},
)
data = response.json()
{
"data": [
{
"id": "bug_8a1b2c3d",
"project_id": "test",
"title": "Inventory icon flickers when opening menu",
"description": "When the inventory menu is opened quickly after a level transition, the inventory icon briefly flickers in and out.",
"reproduction_steps": "1. Complete a level. 2. Press the inventory button immediately after the transition.",
"severity": "medium",
"category": "ui",
"confidence": "high",
"tags": ["ui", "menu"],
"details": null,
"status": "active",
"suppress_reporting": false,
"occurrence_count": 4,
"created_at": "2026-04-01T10:00:00.000000+00:00",
"created_by": "reviewer@example.com"
}
],
"pagination": {
"page": 0,
"page_size": 20,
"total_count": 1,
"total_pages": 1
}
}
Authorizations
API key for authentication
Path Parameters
The project ID. You can copy it from the project settings page or the project URL in the dashboard.
Query Parameters
Filter by status
Available options:
active, archived, all Free-text search across title/description/reproduction steps
Filter by severity
Available options:
low, medium, high, critical Filter by bug category
Field to sort by
Sort direction
Available options:
asc, desc Page number (0-indexed)
Results per page (1-100)
Required range:
1 <= x <= 100