Update Webhook

Update a webhook endpoint.

Omitted fields keep their current value. The URL can't be changed; create a new endpoint for a new URL. Sending headers replaces every custom header.

Authorization

api_key

x-access-token<token>

In: header

Path Parameters

webhook_id*string

ID of the webhook endpoint

Request Body

application/json

The fields to change

description?string

Optional note to tell endpoints apart

event_patterns?array<string>

Replaces the endpoint's topics. At least one is required. Topics are listed at https://support.cybership.io/docs/shipos/api/webhooks/list-of-topics

headers?

Replaces every custom header. Send {} to remove them all. Header values are stored encrypted and are never returned by the API.

At most 32 headers.
Names must be HTTP tokens. They are compared case-insensitively and stored in lowercase, so X-Token and x-token together are a duplicate.
Values can have up to 4096 Latin-1 characters and can't contain CR, LF or NUL.
These names are reserved and refused: host, content-length, content-type, connection, transfer-encoding, upgrade, expect, proxy-authorization, proxy-connection, te, trailer, and any name that starts with x-cybr-.

contact_email?string

Address that is emailed when deliveries to this endpoint stop after repeated failures

Response Body

`application/json`

`application/problem+json`

curl -X PATCH "https://example.com/shipos/webhooks/string" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "string",  "url": "string",  "description": "string",  "contact_email": "string",  "paused": true,  "active": true,  "status": "active",  "event_patterns": [    "string"  ],  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "health": {    "consecutive_failures": 0.1,    "last_successful_at": "2019-08-24T14:15:22Z"  },  "circuit": {    "opened_at": "2019-08-24T14:15:22Z",    "reason": "string",    "probe_at": "2019-08-24T14:15:22Z"  },  "supported_actions": [    {      "action": "VIEW_LOGS"    }  ],  "last_delivery": {    "event_type": "string",    "status": "PENDING",    "delivered_at": "2019-08-24T14:15:22Z"  }}

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/problem+json

401application/problem+json

403application/problem+json

404application/problem+json

429application/problem+json

500application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`