Add or replace durable subscribers

Operation boundary

Caller: Trusted backend only
Scope: A missing target Channel is created implicitly; an omitted or zero channel_type is treated as group type 2.
Atomicity: Reset removal, chunked insertion, and large refresh are separate stages and may partially complete.

POST/channel/subscriber_add

Adds non-blank subscribers; channel_type 0 becomes group type 2 and reset=1 replaces the snapshot.

Request Body

application/json

Ordinary subscribers to add or replace.

TypeScript Definitions

Use the request body type in TypeScript.

Ordinary-subscriber add or replacement parameters.

channel_id*string

Target non-blank Channel ID; it must not contain # or @.

Match^(?!.*[#@])(?=.*\S).+$

Length1 <= length

channel_type?not (unknown)

Target Channel type; omission or 0 becomes group type 2, while type 1 is rejected.

Formatuint8

Range0 <= value <= 255

Default2

reset?integer

Subscriber-snapshot replacement compatibility flag; exactly 1 enables it and every other integer disables it.

Default0

temp_subscriber?not (unknown)

Deprecated temporary-subscriber flag; value 1 is rejected and every other value is ignored.

subscribers*array<>

One or more non-blank subscriber UIDs to add.

Items1 <= items

[key: string]?any

{  "status": 200}