Upload a preset avatar
Uploads the preset's master avatar (JPEG/PNG/WebP/AVIF, max 5 MB; center- cropped to a 192px square WebP with a content-hash filename). Master files live in the preset's folder and are served at /notification/_preset_<id>/<filename>; they are copied into each domain folder on apply / assignment save. Domains bound to the preset are re- stamped with the new avatar immediately; if the avatar was the last missing piece, the re-stamp switches their banners on automatically (enabled follows the preset's readiness). Requires a write-scoped key.
Authorization
bearerAuth Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.
In: header
Path Parameters
Notification preset id.
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/admin/library/notifications/0/avatar" \ -F file="string"{ "filename": "avatar_9f2c1a7b3d4e5f60.webp"}{ "detail": { "code": "avatar_type", "message": "Only images are allowed (JPEG, PNG, WebP, AVIF)." }}{ "detail": { "code": "preset_not_found", "message": "Preset not found" }}{ "detail": { "code": "avatar_too_large", "message": "File larger than 5 MB" }}Delete a notification preset
Deletes the preset from the library. Domains that serve it keep their stamped copy of the texts and files; the preset simply stops being assignable. Requires a write-scoped key.
Remove a preset avatar
Removes the preset's master avatar. Domains bound to the preset lose it too and their banners are disabled (a banner cannot render without an avatar). Enabled follows the preset's readiness, so re-uploading an avatar switches the bound domains back on automatically. Requires a write-scoped key.