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

# Get an app install's notification settings

> Returns the notification settings an app declares for the given install. Each
setting's `id` is the value to pass as `notificationSettingId` when creating a
notification via POST /v1/notifications. Installs whose backing app declares no
notification settings return an empty `notifications` array.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/installs/{installId}/notification-settings
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/installs/{installId}/notification-settings:
    get:
      tags:
        - Installs
      summary: Get an app install's notification settings
      description: >-
        Returns the notification settings an app declares for the given install.
        Each

        setting's `id` is the value to pass as `notificationSettingId` when
        creating a

        notification via POST /v1/notifications. Installs whose backing app
        declares no

        notification settings return an empty `notifications` array.
      operationId: retrieve-install-notification-settings
      parameters:
        - description: Unique identifier of the app install
          in: path
          name: installId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app_instance.InstallNotificationSettings'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Missing or invalid API key
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: App install not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    app_instance.InstallNotificationSettings:
      properties:
        actionLabel:
          allOf:
            - $ref: '#/components/schemas/app_instance.InstallNotificationActionLabel'
          description: >-
            ActionLabel is the app's generic "[verb] [count] [noun]" label,
            present only when declared.
        notifications:
          description: >-
            Notifications is every notification setting the app exposes for this
            install. Empty when the

            install's backing app declares no settings. A setting's `id` is the
            value to pass as

            `notificationSettingId` when creating a notification via POST
            /v1/notifications. If the

            recipient's preferences disable every requested delivery target for
            a setting, that POST

            creates nothing and returns 202.
          items:
            $ref: '#/components/schemas/app_instance.InstallNotificationSetting'
          type: array
        object:
          example: notificationSettings
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
    app_instance.InstallNotificationActionLabel:
      properties:
        pluralNoun:
          example: invoices
          type: string
        singularNoun:
          example: invoice
          type: string
        verb:
          example: review
          type: string
      type: object
    app_instance.InstallNotificationSetting:
      properties:
        default:
          allOf:
            - $ref: >-
                #/components/schemas/app_instance.InstallNotificationSurfaceDefaults
          description: >-
            Default is the per-internal-user default delivery state for each
            surface.
        id:
          description: >-
            ID is the stable identifier to pass as `notificationSettingId` when
            creating a notification.
          example: invoice-paid
          type: string
        label:
          description: Label is the human-readable name shown to internal users.
          example: Invoice paid
          type: string
        surfaces:
          description: Surfaces are the delivery channels this setting supports.
          example:
            - product
            - email
          items:
            enum:
              - product
              - email
            type: string
          type: array
      type: object
    app_instance.InstallNotificationSurfaceDefaults:
      properties:
        email:
          description: >-
            Email is true when the email channel starts enabled for internal
            users.
          example: false
          type: boolean
        product:
          description: >-
            Product is true when the in-product channel starts enabled for
            internal users.
          example: true
          type: boolean
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````