Skip to main content
GET
List issues

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

project_id
string
required

Project ID.

status
enum<string>

Canonical issue status filter. Omit for open and in-review issues.

Available options:
open,
in_progress,
resolved,
dismissed,
all
agent_name
string

Exact agent name.

query
string

Case-insensitive title match, max 200 characters.

Maximum string length: 200
monitor_id
string

Filter to one monitor's issues. When set, occurrence_count, trace_count and last_seen_at are scoped to that monitor and the trace-time window, and dismissed issues whose dismissal feedback is still outstanding are included.

start_inclusive
string

Trace-time window start (ISO-8601). Optional; only meaningful with monitor_id.

end_exclusive
string

Exclusive trace-time window end (ISO-8601); must be after start_inclusive. Optional; only meaningful with monitor_id.

category
enum<string>

Issue category filter.

Available options:
retry_loop,
integration_failure,
skipped_work,
misread_instruction,
out_of_scope_work,
instruction_violation,
hallucination,
communication,
factual_misrepresentation,
environment_failure,
unsupported_request
min_occurrences
integer

Minimum occurrence count.

Required range: x >= 0
max_occurrences
integer

Maximum occurrence count.

Required range: x >= 0
first_seen_start
string

First-seen window start (ISO-8601).

first_seen_end
string

First-seen window end; must be after first_seen_start.

last_seen_start
string

Last-seen window start (ISO-8601).

last_seen_end
string

Last-seen window end; must be after last_seen_start.

pinned
boolean

Filter by pin state.

assignee_user_id
string | null

Assignee filter. null keeps unassigned issues.

tag_id
string

Filter to issues carrying this tag.

limit
integer

Page size, 1 to 100.

Required range: 1 <= x <= 100
cursor
string

Opaque. Omit it on the first call. The next page is next_request.arguments. It expires after 15 minutes and matches you, the project, the filters, and the sort.

Response

Issue page

issues
object[]
required
total
number
required
next_request
object | null
required