> ## 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.

# List Notifications

> List notifications for the authenticated user's current team, most recent first. Filter with type, unread, severity, important, agentRunId, or processId; paginate with limit/cursor. Requires the Notification Center feature; returns 404 when it is not enabled for the team.



## OpenAPI

````yaml /api-reference/openapi.json get /v2/teams/{teamId}/notifications
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.
  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: 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: 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, transformation proposals, and the
      extra-capture-request follow-up loop
paths:
  /v2/teams/{teamId}/notifications:
    get:
      tags:
        - Notifications
      summary: List Notifications
      description: >-
        List notifications for the authenticated user's current team, most
        recent first. Filter with type, unread, severity, important, agentRunId,
        or processId; paginate with limit/cursor. Requires the Notification
        Center feature; returns 404 when it is not enabled for the team.
      operationId: listNotifications
      parameters:
        - schema:
            type: string
            enum:
              - connection_broken
              - job_issue
              - eval_issue
              - job_done
              - background_job
              - schedule_issue
          in: query
          name: type
          required: false
          description: >-
            Only return notifications of this type. One of: connection_broken,
            job_issue, eval_issue, job_done, background_job, schedule_issue.
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
          in: query
          name: unread
          required: false
          description: If true, only return unread notifications.
        - schema:
            type: string
            enum:
              - info
              - warning
              - critical
              - success
          in: query
          name: severity
          required: false
          description: >-
            Only return notifications with this severity. One of: info, warning,
            critical, success.
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
          in: query
          name: important
          required: false
          description: >-
            If true, only return important notifications: unresolved
            connection_broken rows pinned until reconnected, removed, or
            dismissed.
        - schema:
            type: string
            format: uuid
          in: query
          name: agentRunId
          required: false
          description: Only return notifications about this agent run.
        - schema:
            type: string
            minLength: 1
          in: query
          name: processId
          required: false
          description: Only return notifications about this Clarity process.
        - schema:
            default: 30
            type: integer
            minimum: 1
            maximum: 100
          in: query
          name: limit
          required: false
          description: Number of notifications per page (1-100, default 30).
        - schema:
            type: string
          in: query
          name: cursor
          required: false
          description: >-
            Opaque cursor from the previous page's nextCursor. Omit for the
            first page.
        - name: teamId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  notifications:
                    type: array
                    items:
                      anyOf:
                        - oneOf:
                            - type: object
                              properties:
                                id:
                                  type: string
                                  format: uuid
                                recipientUserId:
                                  type: string
                                  format: uuid
                                teamId:
                                  nullable: true
                                  type: string
                                  format: uuid
                                severity:
                                  type: string
                                  enum:
                                    - info
                                    - warning
                                    - critical
                                    - success
                                title:
                                  type: string
                                summary:
                                  nullable: true
                                  type: string
                                createdAt:
                                  type: string
                                seenAt:
                                  nullable: true
                                  type: string
                                readAt:
                                  nullable: true
                                  type: string
                                resolvedAt:
                                  nullable: true
                                  type: string
                                dismissedAt:
                                  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
                                - severity
                                - title
                                - summary
                                - createdAt
                                - seenAt
                                - readAt
                                - resolvedAt
                                - dismissedAt
                                - 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
                                severity:
                                  type: string
                                  enum:
                                    - info
                                    - warning
                                    - critical
                                    - success
                                title:
                                  type: string
                                summary:
                                  nullable: true
                                  type: string
                                createdAt:
                                  type: string
                                seenAt:
                                  nullable: true
                                  type: string
                                readAt:
                                  nullable: true
                                  type: string
                                resolvedAt:
                                  nullable: true
                                  type: string
                                dismissedAt:
                                  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
                                - severity
                                - title
                                - summary
                                - createdAt
                                - seenAt
                                - readAt
                                - resolvedAt
                                - dismissedAt
                                - 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
                                severity:
                                  type: string
                                  enum:
                                    - info
                                    - warning
                                    - critical
                                    - success
                                title:
                                  type: string
                                summary:
                                  nullable: true
                                  type: string
                                createdAt:
                                  type: string
                                seenAt:
                                  nullable: true
                                  type: string
                                readAt:
                                  nullable: true
                                  type: string
                                resolvedAt:
                                  nullable: true
                                  type: string
                                dismissedAt:
                                  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
                                - severity
                                - title
                                - summary
                                - createdAt
                                - seenAt
                                - readAt
                                - resolvedAt
                                - dismissedAt
                                - 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
                                severity:
                                  type: string
                                  enum:
                                    - info
                                    - warning
                                    - critical
                                    - success
                                title:
                                  type: string
                                summary:
                                  nullable: true
                                  type: string
                                createdAt:
                                  type: string
                                seenAt:
                                  nullable: true
                                  type: string
                                readAt:
                                  nullable: true
                                  type: string
                                resolvedAt:
                                  nullable: true
                                  type: string
                                dismissedAt:
                                  default: null
                                  nullable: true
                                  type: string
                                type:
                                  type: string
                                  enum:
                                    - connection_broken
                                integrationInstanceId:
                                  nullable: true
                                  type: string
                                  format: uuid
                                provider:
                                  type: string
                                integrationSlug:
                                  type: string
                                instanceName:
                                  type: string
                                brokenReason:
                                  type: string
                                  enum:
                                    - oauth_grant_revoked
                                    - refresh_token_missing
                                ownerUserId:
                                  default: null
                                  nullable: true
                                  type: string
                                  format: uuid
                                ownerName:
                                  default: null
                                  nullable: true
                                  type: string
                              required:
                                - id
                                - recipientUserId
                                - teamId
                                - severity
                                - title
                                - summary
                                - createdAt
                                - seenAt
                                - readAt
                                - resolvedAt
                                - dismissedAt
                                - type
                                - integrationInstanceId
                                - provider
                                - integrationSlug
                                - instanceName
                                - brokenReason
                                - ownerUserId
                                - ownerName
                              additionalProperties: false
                            - type: object
                              properties:
                                id:
                                  type: string
                                  format: uuid
                                recipientUserId:
                                  type: string
                                  format: uuid
                                teamId:
                                  nullable: true
                                  type: string
                                  format: uuid
                                severity:
                                  type: string
                                  enum:
                                    - info
                                    - warning
                                    - critical
                                    - success
                                title:
                                  type: string
                                summary:
                                  nullable: true
                                  type: string
                                createdAt:
                                  type: string
                                seenAt:
                                  nullable: true
                                  type: string
                                readAt:
                                  nullable: true
                                  type: string
                                resolvedAt:
                                  nullable: true
                                  type: string
                                dismissedAt:
                                  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
                              required:
                                - id
                                - recipientUserId
                                - teamId
                                - severity
                                - title
                                - summary
                                - createdAt
                                - seenAt
                                - readAt
                                - resolvedAt
                                - dismissedAt
                                - 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
                            severity:
                              type: string
                              enum:
                                - info
                                - warning
                                - critical
                                - success
                            title:
                              type: string
                            summary:
                              nullable: true
                              type: string
                            createdAt:
                              type: string
                            seenAt:
                              nullable: true
                              type: string
                            readAt:
                              nullable: true
                              type: string
                            resolvedAt:
                              nullable: true
                              type: string
                            dismissedAt:
                              default: null
                              nullable: true
                              type: string
                            type:
                              type: string
                            fallback:
                              type: boolean
                              enum:
                                - true
                          required:
                            - id
                            - recipientUserId
                            - teamId
                            - severity
                            - title
                            - summary
                            - createdAt
                            - seenAt
                            - readAt
                            - resolvedAt
                            - dismissedAt
                            - type
                            - fallback
                          additionalProperties: false
                  nextCursor:
                    nullable: true
                    type: string
                required:
                  - notifications
                  - 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.

````