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

# Aggiorna i tuoi interruttori delle notifiche

> Attiva o disattiva le tue email di avviso (`alerts`: `atb`, `cloud_defender`, `csirt_bulletins`) o le notifiche nella campanella (`bells`: `atb`, `cloud_defender`, `v_ciso`, `csirt_bulletins`) per un'organizzazione di cui fai parte. Ciò che invii si unisce a ciò che è salvato: i servizi che non indichi mantengono i loro interruttori. Un servizio senza licenza nell'organizzazione viene rifiutato con 400. Per impostare gli interruttori di un altro membro, un proprietario usa “Aggiorna ruolo utente dell'organizzazione”.



## OpenAPI

````yaml put /api/v1/settings/notifications
openapi: 3.1.0
info:
  title: Aegister API
  version: 2.12.2
servers: []
security: []
paths:
  /api/v1/settings/notifications:
    put:
      tags:
        - Settings
      summary: Switch your notifications on or off
      description: >-
        Merged with what is stored: sending one service leaves the others as
        they are.
      operationId: settings_notifications_update
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - organization
              properties:
                organization:
                  type: integer
                  description: An organization you belong to.
                alerts:
                  type: object
                  description: >-
                    Alert emails, `{area: boolean}`: `atb`, `cloud_defender`,
                    `csirt_bulletins`.
                bells:
                  type: object
                  description: >-
                    Bell notifications, `{area: boolean}`: `atb`,
                    `cloud_defender`, `v_ciso`, `csirt_bulletins`.
      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:
                      - []
                  data:
                    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: ''
        '400':
          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:
                      - - Invalid data provided
          description: An unknown or unlicensed service, or a value that is not a boolean.
        '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: ''
        '404':
          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: You are not a member of that organization.
      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.