Update webhook

Update the URL or headers of an existing webhook identified by its UUID.

PATCH /webhooks/{uuid}

cURL

cURL

curl \
  -X PATCH 'MEILISEARCH_URL/webhooks/WEBHOOK_UUID' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "header": {
      "referer": null
    }
  }'

200

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://your.site/on-tasks-completed",
  "headers": {
    "Authorization": "Bearer a-secret-token"
  },
  "isEditable": true
}

Authorizations

Authorization · string · header · required

An API key is a token that you provide when making API calls. Read more about how to secure your project.

Include the API key to the Authorization header, for instance:

-H 'Authorization: Bearer 6436fc5237b0d6e0d64253fbaac21d135012ecf1'

If you use a SDK, ensure you instantiate the client with the API key, for instance with JS SDK:

const client = new MeiliSearch({
  host: 'MEILISEARCH_URL',
  apiKey: '6436fc5237b0d6e0d64253fbaac21d135012ecf1'
});

Path Parameters

uuid · string<uuid> · required

Universally unique identifier of the webhook.

Body

application/json

Configuration for a webhook endpoint

url · string | null

URL endpoint to call when tasks complete.

Example:

"https://your.site/on-tasks-completed"

headers · object

HTTP headers to include in webhook requests.

Show child attributes

Example:

{ "Authorization": "Bearer a-secret-token" }

Response

200

application/json

Webhook updated successfully. Returns the webhook with metadata and redacted authorization headers.

Webhook object with metadata and redacted authorization headers.

uuid · string<uuid> · required

Unique identifier of the webhook.

isEditable · boolean · required

Whether the webhook can be edited.

url · string | null

URL endpoint to call when tasks complete.

Example:

"https://your.site/on-tasks-completed"

headers · object

HTTP headers to include in webhook requests.

Show child attributes

Example:

{ "Authorization": "Bearer a-secret-token" }