patch /v1/notifications/channels/{id}
Update channel(url/events/status/config/secrets;channel_type 与 id 不可变)
Free (not billed). secrets 逐键合并:留空的已有键保留原值,新键必须填值,删除键即删除。url 变更会把未完结 deliveries(pending/failed/dead)改派到新地址;delivered 行保留历史地址。
Auth: Authorization: Bearer ac-… · billed per call (see Credits) — envelope {success,data,credit_cost} or {success:false,error}.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id * |
path | string |
channel id |
Request body
| Field | Type | Description |
|---|---|---|
name |
string (len≥1 len≤80 /^[^\r\n]*$/) | null |
|
url |
string uri (/^https?:///) |
|
events |
enum("crawl.started", "crawl.completed", "crawl.failed", "monitor.page", "monitor.check.completed")[] |
|
status |
enum("active", "disabled") |
|
config |
object |
|
secrets |
object |
Full request schema
{
"$ref": "#/components/schemas/ChannelPatch"
}Responses
| Status | Description | Body |
|---|---|---|
200 | OK | application/json — object |
default | Error | application/json — ErrorResponse |