---
title: "POST /"
method: POST
path: "/"
deprecated: true
---

# POST /

`POST /`

> **Deprecated.**

Deprecated alias for `POST /notifications`.

## Request body

- NotificationSendOptions
  - `recipients` union, required
    - object
      - `type` 'entity', required
      - `entityRef` union, required — A single entity ref, or a list of entity refs.
        - string
        - string[]
      - `excludeEntityRef` union — A single entity ref, or a list of entity refs.
        - string
        - string[]
    - object
      - `type` 'broadcast', required
  - `payload` NotificationPayload, required
    - `title` string, required — Notification title
    - `description` string — Optional longer description for the notification
    - `link` string — Optional link where the notification is pointing to
    - `severity` 'critical' | 'high' | 'normal' | 'low'
    - `topic` string — Optional notification topic
    - `scope` string — Notification scope, can be used to re-send same notifications in case the scope and origin matches.
    - `icon` string — Optional notification icon
    - `metadata` object — Optional additional customizable metadata.

## Response `200`

The notifications that were created.

- Notification[]
  - `id` string, required — Unique identifier for the notification.
  - `user` string, nullable, required — User entity reference, or null for broadcast notifications.
  - `created` string, date-time, required
  - `saved` string, date-time, nullable
  - `read` string, date-time, nullable
  - `updated` string, date-time, nullable
  - `origin` string, required — Origin of the notification (the sender's reference).
  - `payload` NotificationResponsePayload, required — Response variant of NotificationPayload. Optional string fields may be returned as null when unset.
    - `title` string, required
    - `description` string, nullable
    - `link` string, nullable
    - `severity` 'critical' | 'high' | 'normal' | 'low'
    - `topic` string, nullable
    - `scope` string, nullable
    - `icon` string, nullable
    - `metadata` object

## Other responses

- `default` — An error response from the backend.

---

[API](https://skmtc.dev/backstage/apis/notifications.md) · [All operations](https://skmtc.dev/backstage/apis/notifications/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/backstage/notifications/revisions/a6a1f260951b/schema)