Set/rotate a channel's ESP webhook signing secret

Requires EDITOR. Only valid for resend/aliyun channels (others 400). Stores the secret (encrypted at rest) without requiring the send credentials.

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

Tenant project id (row-level isolation on every query).

id

required

string

Resource id.

Request Body^required

Media typeapplication/json

object

webhookSecret

required

string

>= 1 characters <= 500 characters

Example^generated

json

{
  "webhookSecret": "example"
}

Responses

200

Acknowledged.

Media typeapplication/json

object

ok

boolean

400

Validation error, or channel kind does not receive ESP webhooks.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

401

Not authenticated (no valid session/principal).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

403

Authenticated but lacks the required project role.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

404

Resource not found (or belongs to another project — indistinguishable).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}