# API reference

Use the versioned API for notification creation, agent-readable notification context, and scoped metadata mutation; dashboard and account endpoints are not public APIs.

## Public v1 operations

| Method | Path | Result |
| --- | --- | --- |
| GET | /api/v1/notifications/{id} | Return the complete stored context for a notification owned by the key's source. |
| POST | /api/v1/notifications | Create or deduplicate a notification. |
| POST | /api/v1/notifications/{id}/metadata | Add metadata keys that do not yet exist. |
| PATCH | /api/v1/notifications/{id}/metadata | Modify metadata keys that already exist. |

> **Same-source authorization.** Read and metadata operations can address only a notification owned by the source and account selected by the bearer key. A notification id identifies a resource but never authorizes access; missing and out-of-scope ids both return not_found.

## Machine-readable contracts

- [OpenAPI 3.1](/openapi.json)
- [Create request schema](/json-schema/create-notification.request.schema.json)
- [Public error schema](/json-schema/public-error.response.schema.json)
- [Agent index](/llms.txt)