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

# Get notification sound file

> Public endpoint serving the default notification MP3 used by the webchat widget and the agent client to chirp on new messages. Falls back to an inline base64 beep when the static file is unreachable so the client never sees a broken sound URL.



## OpenAPI

````yaml /api-reference/openapi.yaml get /api/webhook/notification-sound
openapi: 3.0.3
info:
  title: Tether Relay and Tether API
  version: 1.0.0
  description: >-
    Route-derived OpenAPI contract generated from tether-relay backend sources.
    Regenerate with scripts/sync-openapi-from-backend.mjs.
servers:
  - url: https://your-instance.example.com
    description: Production
  - url: http://localhost:2212
    description: Local API service
security: []
tags:
  - name: AI
  - name: Applications
  - name: Approval
  - name: Auth
  - name: Automations
  - name: Calls
  - name: Campaigns
  - name: Contact Analytics
  - name: Contact Metrics
  - name: Contact Notes
  - name: Contacts
  - name: Conversation Monitor
  - name: Conversations
  - name: Departments
  - name: Email
  - name: Escalation Dashboard
  - name: Event Logs
  - name: Google Sheets
  - name: Marketplace
  - name: Messages
  - name: Notification Sounds
  - name: Notifications
  - name: Org Snapshots
  - name: Organizations
  - name: Outreach
  - name: Outreach Metrics
  - name: Outreach Sources
  - name: Pipelines
  - name: Processes
  - name: Prompts
  - name: Reminders
  - name: Sms
  - name: Templates
  - name: Traces
  - name: Training
  - name: Upload
  - name: User Snapshots
  - name: Users
  - name: Vertical
  - name: Webchats
  - name: Webhook
paths:
  /api/webhook/notification-sound:
    get:
      tags:
        - Webhooks
      summary: Get notification sound file
      description: >-
        Public endpoint serving the default notification MP3 used by the webchat
        widget and the agent client to chirp on new messages. Falls back to an
        inline base64 beep when the static file is unreachable so the client
        never sees a broken sound URL.
      operationId: get_webhook_notification_sound
      responses:
        '200':
          description: >-
            MP3 audio file returned with `Content-Type: audio/mpeg`. When the
            static asset is unreachable the endpoint serves an inline
            base64-encoded fallback beep — the response is still a valid MP3 but
            very short (~1 KB).
          content:
            audio/mpeg:
              schema:
                type: string
                format: binary
                description: >-
                  Binary MP3 stream. Roughly 12 KB for the default sound; ~1 KB
                  for the inline fallback beep.
                example: '<binary: MP3 audio stream — Content-Type: audio/mpeg, ~12 KB>'
        '404':
          description: Sound file not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookAssetErrorResponse'
components:
  schemas:
    WebhookAssetErrorResponse:
      type: object
      description: >-
        Error envelope returned by the static-asset webhook routes
        (`/api/webhook/webchat-script` and `/api/webhook/notification-sound`).
        The 200 path serves binary/script content; only failure responses are
        JSON.
      properties:
        error:
          type: string
        message:
          type: string
      additionalProperties: true
      example:
        error: Webchat configuration not found

````