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

# Update your notification switches

> Switch your own alert emails (`alerts`: `atb`, `cloud_defender`, `csirt_bulletins`) or bell notifications (`bells`: `atb`, `cloud_defender`, `v_ciso`, `csirt_bulletins`) on or off for one organization you belong to. What you send is merged with what is stored: services you leave out keep their switches. A service the organization has no licence for is refused with 400. To set another member's switches, an Owner uses “Update organization user role”.



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