Update a webhook endpoint

Changes the URL, events or enabled flag, or rotates the signing secret. Fields left out keep their values. The response includes secret only when it was rotated.

POST
/settings/webhooks/update
Serverhttps://api.medialit.cloud
Authentication
Body

Authentication

  • Bearer token (JWT)

  • Or API key in the x-medialit-apikey header

Request body

application/json
required
  • idstring
    required
  • urlstring
  • eventsarray<string>

    Events to send. Defaults to every event.

  • enabledboolean
  • rotateSecretboolean

    Replace the signing secret with a new one.

Responses

200
The updated endpoint
  • idstring
    required
  • urlstring
    required
  • eventsarray<string>
    required

    Events to send. Defaults to every event.

  • enabledboolean
    required
  • secretHintstring
    required

    The signing secret's last characters.

  • secretstring

    Signing secret (Standard Webhooks). Returned only when the endpoint is created or its secret rotated; read it with POST /settings/webhooks/secret.

  • createdAtstring (date-time)
    required
  • updatedAtstring (date-time)
    required
400
Bad Request
  • errorstring
    required
401
Unauthorized
  • errorstring
    required
403
Forbidden
No response body.
404
Not Found
  • errorstring
    required
500
Internal Server Error
  • errorstring
    required