# Notifications

> The Notifications operations of the Hub REST API (1 operation).

URL: https://docs.synap.live/docs/reference/hub-api/notifications · Generated from Synap-core/backend@c31e261ab (main)

Paths are relative to `/api/hub` on a pod.

## POST /notifications

Create a notification

Persists a notification (e.g. skill.triggered) and emits notification:new to the frontend.

Request body (`application/json`): CreateNotificationRequest

| Field | Type | Required | Description |
|---|---|---|---|
| `userId` | string | yes |  |
| `workspaceId` | string | yes |  |
| `type` | string | yes | Registry type, e.g. skill.triggered, proposal.created, ai_request.vault_access. |
| `sourceType` | NotificationSourceType |  |  |
| `sourceId` | string |  |  |
| `workspaceUrl` | string |  |  |
| `groupKey` | string |  |  |
| `data` | object |  |  |

Responses:

- `200`: Created notification id
- `400`: Bad request
- `403`: Forbidden
- `500`: Internal error