> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aegister.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Leggi i tuoi interruttori delle notifiche

> Elenca ogni organizzazione di cui fai parte, i servizi per cui ha una licenza e i tuoi due interruttori per ciascuno: `email` (le email di avviso; `null` per un servizio che non ne invia, come Virtual CISO) e `bell` (le notifiche nella campanella). Ogni interruttore parte spento. Scadenze degli incidenti, scadenza della licenza e limite giornaliero delle API non hanno interruttore. Sono gli interruttori di Profilo → Notifiche. Leggerli chiude la notifica “Scegliete di cosa essere avvisati”.



## OpenAPI

````yaml get /api/v1/settings/notifications
openapi: 3.1.0
info:
  title: Aegister API
  version: 2.12.2
servers: []
security: []
paths:
  /api/v1/settings/notifications:
    get:
      tags:
        - Settings
      summary: Your notification switches
      description: >-
        Every organization you belong to, with the services it is licensed for
        and your email and bell switch for each. Every switch starts off.
        Incident deadlines, licence expiry and the daily API limit have no
        switch. Reading this closes the "Choose what you hear about" bell.
      operationId: settings_notifications_retrieve
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 0
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
                  total:
                    type: number
                    description: >-
                      Total number of items that meet the list filter.  

                      This doesn't represent the number of items inside the
                      `data` array.
                    minimum: 0
                    examples:
                      - 20
                      - 30
                      - 40
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        organization:
                          type: integer
                          description: Organization ID.
                        name:
                          type: string
                          description: Organization name.
                        logo:
                          type: string
                          nullable: true
                          description: Organization logo URL.
                        services:
                          type: array
                          description: >-
                            The services the organization is licensed for, each
                            with your two switches.
                          items:
                            type: object
                            properties:
                              area:
                                type: string
                                enum:
                                  - atb
                                  - cloud_defender
                                  - v_ciso
                                  - csirt_bulletins
                              email:
                                type: boolean
                                nullable: true
                                description: >-
                                  Alert emails. `null`: the service sends no
                                  mail.
                              bell:
                                type: boolean
                                description: Bell notifications.
          description: ''
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
          description: ''
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Aegister-Token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.