Update a webhook (secret redacted in response)

Requires EDITOR. Same URL SSRF validation as create.

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

>= 1 properties

name

string

>= 1 characters <= 120 characters

url

string

eventTypes

Array<string>

>= 1 items

active

boolean

Example^generated

json

{
  "name": "example",
  "url": "example",
  "eventTypes": [
    "example"
  ],
  "active": true
}

Responses

200

Updated webhook.

Media typeapplication/json

object

webhook

Project outbound webhook (secret redacted as ‘***’).

object

id

string

projectId

string

name

string

url

string

secret

Always ‘***’ on read endpoints.

string

eventTypes

Array<string>

active

boolean

createdAt

string format: date-time

updatedAt

string format: date-time

400

Validation error or disallowed/insecure URL.

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"
}