address reviewer feedback

Author: guimachiavelli

assets/misc/meilisearch-collection-postman.json

@@ -3107,7 +3107,7 @@
 						],
 						"body": {
 							"mode": "raw",
-							"raw": "{\n    \"name\": \"docs-key\",\n    \"description\": \"Key to add and delete documents, in `books` index.\",\n    \"actions\": [\n        \"documents.add\",\n        \"documents.delete\" \n    ],\n    \"indexes\": [\n        \"books\"\n    ],\n    \"expiresAt\": null\n}"
+							"raw": "{\n    \"url\": \"WEBHOOK_TARGET_URL\",\n    \"headers\": {\n        \"authorization\": \"SECURITY_KEY\",\n        \"referer\": \"https://example.com\"\n    }\n}"
 						},
 						"url": {
 							"raw": "{{url}}/webhooks",
@@ -3134,7 +3134,7 @@
 						],
 						"body": {
 							"mode": "raw",
-							"raw": "{\n    \"description\": \"Key to add and delete documents, but also to create indexes, in `book` index.\"\n}"
+							"raw": "{\n    \"header\": {\n        \"referer\": null\n    }\n}"
 						},
 						"url": {
 							"raw": "{{url}}/webhooks/WEBHOOK_UUID",

reference/api/keys.mdx

@@ -78,7 +78,7 @@ Custom API keys are deterministic: `key` is a SHA256 hash of the `uid` and maste
 **Default value**: N/A<br />
 **Description**: An array of API actions permitted for the key, represented as strings. API actions are only possible on authorized [`indexes`](#indexes). `["*"]` for all actions.
 
-You can use `*` as a wildcard to access all endpoints for the `documents`, `indexes`, `tasks`, `settings`, `stats` and `dumps` actions. For example, `documents.*` gives access to all document actions.
+You can use `*` as a wildcard to access all endpoints for the `documents`, `indexes`, `tasks`, `settings`, `stats`, `webhooks`, and `dumps` actions. For example, `documents.*` gives access to all document actions.
 
 <Warning>
 For security reasons, we do not recommend creating keys that can perform all actions.

reference/api/webhooks.mdx

@@ -28,7 +28,7 @@ Use the `/webhooks` to trigger automatic workflows when Meilisearch finishes pro
 - `uuid`: a v4 uuid Meilisearch automatically generates when you create a new webhook
 - `url`: a string indication the URL Meilisearch should notify whenever it completes a task, required
 - `headers`: an object with HTTP headers and their values, optional, often used for authentication
-- `isEditable`: read-only Boolean field indicating whether you can edit the webhook. Meilisearch automatically sets this to false for its internal webhooks
+- `isEditable`: read-only Boolean field indicating whether you can edit the webhook. Meilisearch automatically sets this to `true` for all webhooks created via the API and to `false` for reserved webhooks
 
 ## The webhook payload
 
@@ -96,6 +96,8 @@ Get a single webhook configured in the current Meilisearch instance.
 
 Create a new webhook. When Meilisearch finishes processing a task, it sends the relevant [task object](/reference/api/tasks#task-object) to all configured webhooks.
 
+You can create up to 20 webhooks. Having multiple webhooks active at the same time may negatively impact performance.
+
 ### Example
 
 <CodeSamplesWebhooksPost1 />

reference/errors/error_codes.mdx

@@ -84,7 +84,7 @@ The [`updatedAt`](/reference/api/indexes#index-object) field of an index cannot
 
 ### `immutable_webhook`
 
-You tried to modify a reserved [webhook](/reference/api/webhooks). Reserved webhooks are configured by Meilisearch Cloud and have `isEditable` set to `true`. Webhooks created with an instance option are also ummutable.
+You tried to modify a reserved [webhook](/reference/api/webhooks). Reserved webhooks are configured by Meilisearch Cloud and have `isEditable` set to `true`. Webhooks created with an instance option are also immutable.
 
 ### `immutable_webhook_uuid`