Skip to main content
GET
List Notifications

Authorizations

Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

teamId
string
required

Query Parameters

type
enum<string>

Only return notifications of this type. One of: connection_broken, job_issue, eval_issue, job_done, background_job, schedule_issue.

Available options:
connection_broken,
job_issue,
eval_issue,
job_done,
background_job,
schedule_issue
unread
enum<string>

If true, only return unread notifications.

Available options:
true,
false
severity
enum<string>

Only return notifications with this severity. One of: info, warning, critical, success.

Available options:
info,
warning,
critical,
success
important
enum<string>

If true, only return important notifications: unresolved connection_broken rows pinned until reconnected, removed, or dismissed.

Available options:
true,
false
agentRunId
string<uuid>

Only return notifications about this agent run.

processId
string

Only return notifications about this Clarity process.

Minimum string length: 1
limit
integer
default:30

Number of notifications per page (1-100, default 30).

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

Opaque cursor from the previous page's nextCursor. Omit for the first page.

Response

Default Response

notifications
object[]
required
nextCursor
string | null
required