Update an endpoint

PATCH

/v1/endpoints/{id}

const url = 'https://api.hooks.events/v1/endpoints/example';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","environmentId":"example","status":"active","provider":"generic","verificationMode":"none","secret":"example","sourceConfig":{"eventType":"example","deliveryId":"example","actor":"example","subjectTitle":"example","secretHeader":"example","dedupe":{"key":"example","windowSeconds":1}},"rateLimitPerMinute":1,"rateLimitAction":"store","hooks":{"stages":{"received":[{"type":"drop","condition":{"field":"example","op":"equals","value":["example"]}}],"before_transform":[{"type":"drop","condition":{"field":"example","op":"equals","value":["example"]}}],"before_deliver":[{"type":"drop","condition":{"field":"example","op":"equals","value":["example"]}}],"after_deliver":[{"type":"drop","condition":{"field":"example","op":"equals","value":["example"]}}],"on_failure":[{"type":"drop","condition":{"field":"example","op":"equals","value":["example"]}}],"on_dead":[{"type":"drop","condition":{"field":"example","op":"equals","value":["example"]}}]}}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PATCH \
  --url https://api.hooks.events/v1/endpoints/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "environmentId": "example", "status": "active", "provider": "generic", "verificationMode": "none", "secret": "example", "sourceConfig": { "eventType": "example", "deliveryId": "example", "actor": "example", "subjectTitle": "example", "secretHeader": "example", "dedupe": { "key": "example", "windowSeconds": 1 } }, "rateLimitPerMinute": 1, "rateLimitAction": "store", "hooks": { "stages": { "received": [ { "type": "drop", "condition": { "field": "example", "op": "equals", "value": [ "example" ] } } ], "before_transform": [ { "type": "drop", "condition": { "field": "example", "op": "equals", "value": [ "example" ] } } ], "before_deliver": [ { "type": "drop", "condition": { "field": "example", "op": "equals", "value": [ "example" ] } } ], "after_deliver": [ { "type": "drop", "condition": { "field": "example", "op": "equals", "value": [ "example" ] } } ], "on_failure": [ { "type": "drop", "condition": { "field": "example", "op": "equals", "value": [ "example" ] } } ], "on_dead": [ { "type": "drop", "condition": { "field": "example", "op": "equals", "value": [ "example" ] } } ] } } }'

Requires the endpoints:write scope.

Authorizations

apiKey
sessionCookie

Parameters

Path Parameters

required

string

Request Body^required

application/json

object

name

string

>= 1 characters <= 100 characters

environmentId

Any of:

string
null

string

>= 1 characters

status

string

Allowed values: active paused

provider

string

Allowed values: generic github gitlab shopify intercom zendesk stripe slack linear sentry jira pagerduty standard-webhooks svix vercel twilio discord bitbucket typeform calendly

verificationMode

string

Allowed values: none hmac shared-secret

secret

string

>= 16 characters <= 256 characters

sourceConfig

object

eventType

string

>= 1 characters <= 200 characters

deliveryId

string

>= 1 characters <= 200 characters

actor

string

>= 1 characters <= 200 characters

subjectTitle

string

>= 1 characters <= 200 characters

secretHeader

string

>= 1 characters <= 64 characters

dedupe

object

key

required

string

>= 1 characters <= 500 characters

windowSeconds

integer

>= 1 <= 86400

rateLimitPerMinute

Any of:

integer
null

integer

>= 1 <= 100000

rateLimitAction

string

Allowed values: store drop

hooks

Any of:

object
null

object

stages

required

object

received

Array

<= 10 items

One of:

object

type

required

string

Allowed value: drop

condition

Any of:

object

field

required

string

>= 1 characters <= 200 characters

required

string

Allowed values: equals not_equals in contains matches exists

value

Any of:

string

<= 1000 characters

before_transform

Array

<= 10 items

One of:

object

type

required

string

Allowed value: drop

condition

Any of:

object

field

required

string

>= 1 characters <= 200 characters

required

string

Allowed values: equals not_equals in contains matches exists

value

Any of:

string

<= 1000 characters

before_deliver

Array

<= 10 items

One of:

object

type

required

string

Allowed value: drop

condition

Any of:

object

field

required

string

>= 1 characters <= 200 characters

required

string

Allowed values: equals not_equals in contains matches exists

value

Any of:

string

<= 1000 characters

after_deliver

Array

<= 10 items

One of:

object

type

required

string

Allowed value: drop

condition

Any of:

object

field

required

string

>= 1 characters <= 200 characters

required

string

Allowed values: equals not_equals in contains matches exists

value

Any of:

string

<= 1000 characters

on_failure

Array

<= 10 items

One of:

object

type

required

string

Allowed value: drop

condition

Any of:

object

field

required

string

>= 1 characters <= 200 characters

required

string

Allowed values: equals not_equals in contains matches exists

value

Any of:

string

<= 1000 characters

on_dead

Array

<= 10 items

One of:

object

type

required

string

Allowed value: drop

condition

Any of:

object

field

required

string

>= 1 characters <= 200 characters

required

string

Allowed values: equals not_equals in contains matches exists

value

Any of:

string

<= 1000 characters

Responses

200

Success

application/json

object

required

boolean

key

additional properties

Example ^generated

{
  "ok": true
}

400

Validation error

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

string

requestId

required

Request id, also echoed in x-request-id

string

key

additional properties

Example ^generated

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

401

Missing or invalid credentials

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

string

requestId

required

Request id, also echoed in x-request-id

string

key

additional properties

Example ^generated

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

403

The credential lacks the required scope, or the workspace is not writable

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

string

requestId

required

Request id, also echoed in x-request-id

string

key

additional properties

Example ^generated

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

404

Resource not found

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

string

requestId

required

Request id, also echoed in x-request-id

string

key

additional properties

Example ^generated

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

429

Rate limited

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

string

requestId

required

Request id, also echoed in x-request-id

string

key

additional properties

Example ^generated

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

Headers

X-RateLimit-Limit

integer

Requests allowed per window

X-RateLimit-Remaining

integer

X-RateLimit-Reset

integer

Seconds until the window resets

Update an endpoint

Authorizations

Parameters

Path Parameters

Request Bodyrequired

Responses

200

Example generated

400

Example generated

401

Example generated

403

Example generated

404

Example generated

429

Example generated

Headers

Request Body^required

Example ^generated

Example ^generated

Example ^generated

Example ^generated

Example ^generated

Example ^generated