Edit the draft notification banner

Partially updates the draft notification banner. Only supplied fields change; omit a field to leave it untouched. Enabling the banner requires title, body, link_text and an uploaded avatar; target_url is additionally required only in the 'manual' link mode — in the default smart-link mode ('') a banner click mirrors the matched segment's primary button and needs no URL of its own. assignment binds the banner to library presets — the first enabled preset is stamped into the domain, and 2+ enabled presets run a creative A/B. Requires a write-scoped key.

Authorization

bearerAuth

AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Path Parameters

domain*string

Registered hostname, e.g. onlydasha.com.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

enabled?boolean

Whether the banner is shown on the live page.

title?string

Bold headline text.

Lengthlength <= 128

body?string

Banner body text.

Lengthlength <= 256

link_text?string

Call-to-action label.

Lengthlength <= 64

target_url?string

Destination URL (http/https). Pass an empty string to clear. Required to enable the banner only in the 'manual' link mode; in smart-link mode it is just the last-resort fallback when the matched segment has no button to mirror.

Lengthlength <= 2048

link_mode?string

Where a banner click goes. '' (default) — smart link: the click mirrors the matched segment's primary button, following the same tier-aware routing and A/B arm the buttons use; no URL required. 'manual' — own link: target_url is required and wins over the segment mirror.

Value in

""
"manual"

delay_ms?integer

Delay before the banner appears, in milliseconds.

Range500 <= value <= 10000

translations?

Per-locale public text overrides keyed by 2-letter language code, each with optional title/body/link_text. Pass {} to clear. target_url can never be translated.

assignment?|

Which library presets this domain's banner serves — the engine behind the Notification tab's checkbox cards. Send {"items": [...]} to replace the assignment wholesale; {"items": []} clears it (back to the hand-edited single banner); omit the field to leave it unchanged. Every enabled preset is validated: an unknown id returns 404 preset_not_found, and a preset missing its texts, its avatar or — in the 'manual' link mode — its link returns 400 preset_incomplete. On save the first enabled preset is stamped into the domain banner (texts, files and preset_id) and the enabled presets' master files are copied into the domain folder, so the banner serves immediately. Two or more enabled presets run a creative A/B: visitors are rotated across the presets (sticky per subnet) and weight sets each preset's share of impressions.

style?|

Banner appearance overrides. Sparse: only the keys you set are stored; {} resets to the stock look.

Response Body

`application/json`

curl -X PATCH "https://example.com/api/admin/notification/string" \  -H "Content-Type: application/json" \  -d '{    "enabled": true,    "title": "New post is live",    "body": "Tap to see what you\'ve been missing",    "link_text": "Open",    "target_url": "https://onlyfans.com/dasha",    "link_mode": "",    "delay_ms": 2500,    "translations": {      "es": {        "title": "Nueva publicacion",        "body": "Toca para ver",        "link_text": "Abrir"      }    }  }'

{  "domain": "onlydasha.com",  "enabled": true,  "avatar_filename": "avatar-9f2a.webp",  "sound_filename": null,  "title": "New post is live",  "body": "Tap to see what you've been missing",  "link_text": "Open",  "target_url": "https://onlyfans.com/dasha",  "link_mode": "",  "delay_ms": 2500,  "updated_at": 1719767000,  "translations": {    "es": {      "title": "Nueva publicacion",      "body": "Toca para ver",      "link_text": "Abrir"    }  },  "style": null,  "preset_id": null,  "assignment": null}

{  "detail": {    "code": "notification_incomplete",    "message": "To enable the notification, fill in all fields and upload an avatar."  }}

{  "detail": {    "code": "domain_not_found",    "message": "Domain 'onlydasha.com' is not registered"  }}

Edit the draft notification banner

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

404application/json

`application/json`

`application/json`

`application/json`