> ## Documentation Index > Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Notification Feed > List the notification feed for the authenticated user's current team, most recent activity first. Each item is either an individual notification or a notification batch (a per-agent group of job_issue/eval_issue/job_done/schedule_issue notifications). Filter with type, unread, and either severity (exact match) or minSeverity (threshold; the two are mutually exclusive); paginate with limit/cursor. Either severity filter also narrows a surfaced batch's counts to its qualifying members, and hides a batch with no qualifying live member. The feed is eventually consistent — a batch's counts can lag a concurrent write by one page fetch. Requires the Notification Center feature; returns 404 when it is not enabled for the team. ## OpenAPI ````yaml https://api.duvo.ai/v2/documentation/mintlify.json get /v2/teams/{teamId}/notifications/feed openapi: 3.0.3 info: title: Duvo Public API description: >- Public API for programmatic access to Duvo. Authenticate with API keys created in the Duvo dashboard. ## Rate limits Requests are counted per API key. Every response advertises the quota with the IETF RateLimit fields, so a client can self-throttle without waiting for a rejection: - `RateLimit-Policy: "default";q=;w=` — the policy in force: `q` requests per `w` seconds. - `RateLimit: "default";r=;t=` — the live state: `r` requests left, quota resetting in `t` seconds. - Read the quota from the headers rather than hard-coding it; it differs per environment. - The same numbers are also sent as `ratelimit-limit`, `ratelimit-remaining` and `ratelimit-reset`. Once the quota is exhausted the API answers `429 Too Many Requests` with `Retry-After` set to the seconds to wait; honor it instead of retrying immediately. version: 1.0.0 servers: - url: https://api.duvo.ai description: Production server security: [] tags: - name: Runs description: Start, monitor, and manage agent runs (Runs in the Duvo UI) - name: Sandboxes description: Create sandboxes and upload files for agent runs - name: Queues description: Manage queues and their agent bindings - name: Cases description: Create, list, and manage cases and their labels within queues - name: Case Approvals description: Submit decisions on pending case approval requests issued by an agent run - name: Case Attachments description: Upload, list, download, and remove the files attached to a case - name: Automations description: >- List and manage automations — the workspace container that groups the agents and queues making up one end-to-end process - name: Agents description: Create and manage agents for automation workloads - name: Revisions description: Create and manage agent revisions — the underlying Setup for an Agent - name: Agent Folders description: Organize agents into folders - name: Agent Memory description: Read an agent's memory files (the Memory feature in the Duvo UI) - name: Suggestions description: >- List, apply, and dismiss an Agent's improvement suggestions (the suggestions inbox in the Duvo UI) - name: Notifications description: >- List, read, dismiss, and clear the authenticated user's team notifications (the Notification Center in the Duvo UI) - name: Schedules description: List schedules configured for an agent - name: Duvo Pulse description: >- Create, list, iterate on, and delete Duvo Pulse dashboards — live, agent-generated visualizations of your Duvo data - name: Case Triggers description: >- Configure case triggers that automatically dispatch agent runs (Runs in the Duvo UI) for cases added to a queue - name: Triggers description: >- Configure event triggers that start a Run automatically when an external event fires (e.g. an email arrives, a Linear issue is created, or a file changes in Google Drive) - name: Skills description: Manage team and system skills (reusable knowledge packs). - name: Files description: Manage team files. - name: Plugins description: Discover plugins that can be referenced from a revision. - name: Organizations description: Inspect organizations you belong to and the teams within them - name: Team description: Inspect the team and members associated with the API key - name: Invites description: >- Invite people to a team — one at a time or in bulk, scoped to a Clarity process or the whole team — and manage the team's shareable invite link - name: Integrations description: Browse the team's catalog of available integration types - name: Connections description: Manage your connected integrations - name: Credentials description: >- Manage logins (domain + username + password + TOTP) used by agents to sign in to websites and desktop applications, and attach them to assignment revisions - name: Secrets description: >- Manage env-var secrets injected into runs, and attach them to assignment revisions. Only metadata is exposed; values are never returned - name: Revision Integrations description: >- Attach integrations to assignment revisions, pin specific connections, and link queues - name: ClarityV2 description: >- Manage Clarity v2 process snapshots, automation proposals, and the extra-capture-request follow-up loop paths: /v2/teams/{teamId}/notifications/feed: get: tags: - Notifications summary: Get Notification Feed description: >- List the notification feed for the authenticated user's current team, most recent activity first. Each item is either an individual notification or a notification batch (a per-agent group of job_issue/eval_issue/job_done/schedule_issue notifications). Filter with type, unread, and either severity (exact match) or minSeverity (threshold; the two are mutually exclusive); paginate with limit/cursor. Either severity filter also narrows a surfaced batch's counts to its qualifying members, and hides a batch with no qualifying live member. The feed is eventually consistent — a batch's counts can lag a concurrent write by one page fetch. Requires the Notification Center feature; returns 404 when it is not enabled for the team. operationId: getNotificationFeed parameters: - schema: type: string enum: - connection_broken - case_failed - critical_case_issue - case_issue - critical_eval_issue - eval_issue - job_issue - job_done - background_job - schedule_issue - config_proposal in: query name: type required: false description: >- Only return individual notifications of this type and batches with at least one live member of it. - schema: type: string enum: - 'true' - 'false' in: query name: unread required: false description: >- If true, only return unread individual notifications and batches with at least one unread live member. - schema: type: string enum: - info - warning - critical - success in: query name: severity required: false description: >- Only return individual notifications with exactly this severity, and batches with at least one live member of it. A batch's counts then describe only those members. Mutually exclusive with minSeverity. One of: info, warning, critical, success. - schema: type: string enum: - info - warning - critical - success in: query name: minSeverity required: false description: >- Only return individual notifications at or above this urgency, and batches with at least one live member at or above it. A batch's counts and worst severity then describe only its members at or above the threshold. Least to most urgent: success < info < warning < critical. Mutually exclusive with severity. - schema: type: string enum: - mine in: query name: agents required: false description: >- When 'mine', only return notifications for agents the authenticated user created. connection_broken notifications are always returned regardless, because they are not about an agent: a broken connection is only notified to the people who can act on it or escalate it, so filtering by agent authorship would hide it from the reader it was addressed to. - schema: default: 30 type: integer minimum: 1 maximum: 100 in: query name: limit required: false - schema: type: string in: query name: cursor required: false - name: teamId in: path required: true schema: type: string responses: '200': description: Default Response content: application/json: schema: type: object properties: items: type: array items: oneOf: - type: object properties: kind: type: string enum: - batch batch: type: object properties: id: type: string format: uuid agentId: nullable: true type: string format: uuid agentName: type: string nullable: true queueId: default: null nullable: true type: string format: uuid queueName: default: null nullable: true type: string teamId: type: string format: uuid createdAt: type: string lastEventAt: type: string closedAt: type: string nullable: true typeCounts: type: array items: type: object properties: type: type: string description: >- Notification kind. New kinds are added over time. x-extensible-enum: - connection_broken - case_failed - critical_case_issue - case_issue - critical_eval_issue - eval_issue - job_issue - job_done - background_job - schedule_issue - config_proposal total: type: integer minimum: 0 maximum: 9007199254740991 unread: type: integer minimum: 0 maximum: 9007199254740991 required: - type - total - unread additionalProperties: false severityCounts: default: [] type: array items: type: object properties: severity: type: string enum: - info - warning - critical - success total: type: integer minimum: 0 maximum: 9007199254740991 unread: type: integer minimum: 0 maximum: 9007199254740991 required: - severity - total - unread additionalProperties: false unreadCount: type: integer minimum: 0 maximum: 9007199254740991 worstSeverity: type: string enum: - info - warning - critical - success required: - id - agentId - agentName - queueId - queueName - teamId - createdAt - lastEventAt - closedAt - typeCounts - severityCounts - unreadCount - worstSeverity additionalProperties: false required: - kind - batch additionalProperties: false - type: object properties: kind: type: string enum: - notification notification: anyOf: - oneOf: - type: object properties: id: type: string format: uuid recipientUserId: type: string format: uuid teamId: nullable: true type: string format: uuid batchId: default: null nullable: true type: string format: uuid severity: type: string enum: - info - warning - critical - success title: type: string summary: type: string nullable: true createdAt: type: string seenAt: type: string nullable: true readAt: type: string nullable: true resolvedAt: type: string nullable: true dismissedAt: default: null nullable: true type: string occurrenceCount: default: 1 type: integer minimum: 1 maximum: 9007199254740991 lastSeenAt: default: null nullable: true type: string type: type: string enum: - job_issue agentRunId: nullable: true type: string format: uuid evaluationId: nullable: true type: string format: uuid source: type: string enum: - run_failed - run_stuck - eval_flagged - eval_failed agentId: default: null nullable: true type: string format: uuid agentName: default: null nullable: true type: string required: - id - recipientUserId - teamId - batchId - severity - title - summary - createdAt - seenAt - readAt - resolvedAt - dismissedAt - occurrenceCount - lastSeenAt - type - agentRunId - evaluationId - source - agentId - agentName additionalProperties: false - type: object properties: id: type: string format: uuid recipientUserId: type: string format: uuid teamId: nullable: true type: string format: uuid batchId: default: null nullable: true type: string format: uuid severity: type: string enum: - info - warning - critical - success title: type: string summary: type: string nullable: true createdAt: type: string seenAt: type: string nullable: true readAt: type: string nullable: true resolvedAt: type: string nullable: true dismissedAt: default: null nullable: true type: string occurrenceCount: default: 1 type: integer minimum: 1 maximum: 9007199254740991 lastSeenAt: default: null nullable: true type: string type: type: string enum: - job_done agentRunId: nullable: true type: string format: uuid agentId: default: null nullable: true type: string format: uuid agentName: default: null nullable: true type: string required: - id - recipientUserId - teamId - batchId - severity - title - summary - createdAt - seenAt - readAt - resolvedAt - dismissedAt - occurrenceCount - lastSeenAt - type - agentRunId - agentId - agentName additionalProperties: false - type: object properties: id: type: string format: uuid recipientUserId: type: string format: uuid teamId: nullable: true type: string format: uuid batchId: default: null nullable: true type: string format: uuid severity: type: string enum: - info - warning - critical - success title: type: string summary: type: string nullable: true createdAt: type: string seenAt: type: string nullable: true readAt: type: string nullable: true resolvedAt: type: string nullable: true dismissedAt: default: null nullable: true type: string occurrenceCount: default: 1 type: integer minimum: 1 maximum: 9007199254740991 lastSeenAt: default: null nullable: true type: string type: type: string enum: - background_job jobType: type: string enum: - clarity_signavio_export outcome: type: string enum: - succeeded - failed sourceId: type: string format: uuid processId: default: null nullable: true type: string required: - id - recipientUserId - teamId - batchId - severity - title - summary - createdAt - seenAt - readAt - resolvedAt - dismissedAt - occurrenceCount - lastSeenAt - type - jobType - outcome - sourceId - processId additionalProperties: false - type: object properties: id: type: string format: uuid recipientUserId: type: string format: uuid teamId: nullable: true type: string format: uuid batchId: default: null nullable: true type: string format: uuid severity: type: string enum: - info - warning - critical - success title: type: string summary: type: string nullable: true createdAt: type: string seenAt: type: string nullable: true readAt: type: string nullable: true resolvedAt: type: string nullable: true dismissedAt: default: null nullable: true type: string occurrenceCount: default: 1 type: integer minimum: 1 maximum: 9007199254740991 lastSeenAt: default: null nullable: true type: string provider: type: string integrationSlug: type: string instanceName: type: string brokenReason: type: string description: Why the connection stopped working. x-extensible-enum: - oauth_client_invalid - oauth_grant_revoked - refresh_token_missing - insufficient_scopes ownerUserId: default: null nullable: true type: string format: uuid ownerName: default: null nullable: true type: string createdByUserId: default: null nullable: true type: string format: uuid createdByName: default: null nullable: true type: string type: type: string enum: - connection_broken integrationInstanceId: nullable: true type: string format: uuid requiresAction: default: true type: boolean required: - id - recipientUserId - teamId - batchId - severity - title - summary - createdAt - seenAt - readAt - resolvedAt - dismissedAt - occurrenceCount - lastSeenAt - provider - integrationSlug - instanceName - brokenReason - ownerUserId - ownerName - createdByUserId - createdByName - type - integrationInstanceId - requiresAction additionalProperties: false - type: object properties: id: type: string format: uuid recipientUserId: type: string format: uuid teamId: nullable: true type: string format: uuid batchId: default: null nullable: true type: string format: uuid severity: type: string enum: - info - warning - critical - success title: type: string summary: type: string nullable: true createdAt: type: string seenAt: type: string nullable: true readAt: type: string nullable: true resolvedAt: type: string nullable: true dismissedAt: default: null nullable: true type: string occurrenceCount: default: 1 type: integer minimum: 1 maximum: 9007199254740991 lastSeenAt: default: null nullable: true type: string type: type: string enum: - schedule_issue scheduleId: nullable: true type: string format: uuid agentId: nullable: true type: string format: uuid reason: type: string enum: - missing_connections missingConnections: type: array items: type: object properties: integrationType: type: string customIntegrationId: default: null nullable: true type: string format: uuid required: - integrationType - customIntegrationId additionalProperties: false required: - id - recipientUserId - teamId - batchId - severity - title - summary - createdAt - seenAt - readAt - resolvedAt - dismissedAt - occurrenceCount - lastSeenAt - type - scheduleId - agentId - reason additionalProperties: false - type: object properties: id: type: string format: uuid recipientUserId: type: string format: uuid teamId: nullable: true type: string format: uuid batchId: default: null nullable: true type: string format: uuid severity: type: string enum: - info - warning - critical - success title: type: string summary: type: string nullable: true createdAt: type: string seenAt: type: string nullable: true readAt: type: string nullable: true resolvedAt: type: string nullable: true dismissedAt: default: null nullable: true type: string occurrenceCount: default: 1 type: integer minimum: 1 maximum: 9007199254740991 lastSeenAt: default: null nullable: true type: string type: type: string fallback: type: boolean enum: - true required: - id - recipientUserId - teamId - batchId - severity - title - summary - createdAt - seenAt - readAt - resolvedAt - dismissedAt - occurrenceCount - lastSeenAt - type - fallback additionalProperties: false required: - kind - notification additionalProperties: false nextCursor: type: string nullable: true required: - items - nextCursor additionalProperties: false '400': description: Default Response content: application/json: schema: type: object properties: error: type: string message: type: string required: - error additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: error: type: string message: type: string required: - error additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: error: type: string message: type: string required: - error additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: error: type: string message: type: string required: - error additionalProperties: false '500': description: Default Response content: application/json: schema: type: object properties: error: type: string message: type: string required: - error additionalProperties: false security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: API key authentication. Get your API key from the Duvo dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.