Skip to main content
POST
Replace supplied notification-channel settings through the existing dashboard service. Review the app/platform/channel and default-channel effects.
Requires a scoped personal key, explicit project context and current role authorization. See Agent messaging and project operations for review, execution receipts and recovery.

Authorizations

Authorization
string
header
required

Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.

Headers

X-Sendrealm-Project-Id
string<uuid>
required

Body

application/json
app_id
string<uuid>
required

UUID returned by the matching discovery tool in the selected project.

Maximum string length: 36
channel_id
string
required
Required string length: 1 - 160
platform
enum<string>
required
Available options:
android,
ios,
web
name
string
required
Required string length: 1 - 160
description
string

Replaces the current value; omitted clears it.

Maximum string length: 1000
importance
enum<string>

Replaces the current value; omitted defaults to high.

Available options:
min,
low,
default,
high,
max
sound
string

Replaces the current value; omitted clears it.

Maximum string length: 160
vibration
boolean

Replaces the current value; omitted defaults to true.

led_color
string

Replaces the current value; omitted clears it.

Maximum string length: 40
lockscreen_visibility
enum<string>

Replaces the current value; omitted defaults to public.

Available options:
public,
private,
secret
is_default
boolean

Replaces the current value; omitted defaults to false.

Response

Authorized result, preparation, or durable execution receipt.

status
integer
required
data
object
required