add links and error codes

Author: guimachiavelli

learn/async/asynchronous_operations.mdx

@@ -83,7 +83,7 @@ Tasks always contain a field indicating the task's current `status`. This field
 - **`failed`**: a failure occurred when processing the task. No changes were made to the database
 - **`canceled`**: the task was canceled
 
-`succeeded`, `failed`, and `canceled` tasks are finished tasks. Meilisearch keeps them in the task database but has finished processing these tasks. It is possible to [configure a webhook](/learn/self_hosted/configure_meilisearch_at_launch#task-webhook-url) to notify external services when a task is finished.
+`succeeded`, `failed`, and `canceled` tasks are finished tasks. Meilisearch keeps them in the task database but has finished processing these tasks. It is possible to [configure a webhook](/reference/api/webhooks) to notify external services when a task is finished.
 
 `enqueued` and `processing` tasks are unfinished tasks. Meilisearch is either processing them or will do so in the future.
 

learn/async/task_webhook.mdx

@@ -5,7 +5,11 @@ description: Learn how to use webhooks to react to changes in your Meilisearch d
 sidebarDepth: 3
 ---
 
-This guide teaches you how to use webhooks to notify a URL when Meilisearch completed a [task](/learn/async/asynchronous_operations).
+This guide teaches you how to configure a single webhook via instance options to notify a URL when Meilisearch completes a [task](/learn/async/asynchronous_operations).
+
+<Tip>
+If you are using Meilisearch Cloud or need to configure multiple webhooks, use the [`/webhooks` API route](/reference/api/webhooks) instead.
+</Tip>
 
 ## Requirements
 

learn/async/working_with_tasks.mdx

@@ -86,7 +86,7 @@ This will return the full task object:
 }
 ```
 
-If the task is still `enqueued` or `processing`, wait a few moments and query the database once again. If you are working with a self-hosted Meilisearch instance, you may also [set up a webhook listener](/learn/async/task_webhook).
+If the task is still `enqueued` or `processing`, wait a few moments and query the database once again. You may also [set up a webhook listener](/reference/api/webhooks).
 
 When `status` changes to `succeeded`, Meilisearch has finished processing your request.
 

learn/self_hosted/configure_meilisearch_at_launch.mdx

@@ -495,6 +495,8 @@ Notifies the configured URL whenever Meilisearch [finishes processing a task](/l
 
 The webhook payload contains the list of finished tasks in [ndjson](https://github.com/ndjson/ndjson-spec). For more information, [consult the dedicated task webhook guide](/learn/async/task_webhook).
 
+The task webhook option is only available for self-hosted instances. If you are using Meilisearch Cloud, use the [`/webhooks` API route](/reference/api/webhooks) instead.
+
 ### Task webhook authorization header
 
 **Environment variable**: `MEILI_TASK_WEBHOOK_AUTHORIZATION_HEADER`<br />

reference/errors/error_codes.mdx

@@ -82,6 +82,18 @@ The [`uid`](/reference/api/indexes#index-object) field of an index cannot be mod
 
 The [`updatedAt`](/reference/api/indexes#index-object) field of an index cannot be modified.
 
+### `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.
+
+### `immutable_webhook_uuid`
+
+You tried to manually set a webhook `uuid`. Meilisearch automatically generates `uuid` for webhooks.
+
+### `immutable_webhook_is_editable`
+
+You tried to manually set a webhook's `isEditable` field. Meilisearch automatically sets `isEditable` for all webhooks. Only reserved webhooks have `isEditable` set to `false`.
+
 ## `index_already_exists`
 
 An index with this [`uid`](/reference/api/indexes#index-object) already exists, check out our guide on [index creation](/learn/getting_started/indexes).
@@ -595,6 +607,22 @@ The requested task type is invalid. Please use one of the [possible values](/ref
 
 The [`uids`](/reference/api/tasks#query-parameters) query parameter is invalid.
 
+### `invalid_webhooks`
+
+The create webhook request did not contain a valid JSON payload. Meilisearch also returns this error when you try to create more than 20 webhooks.
+
+### `invalid_webhook_url`
+
+The provided webhook URL isn’t a valid JSON value, `null`, or missing.
+
+### `invalid_webhook_headers`
+
+The provided webhook `headers` field is not a JSON object or not a valid HTTP header. Meilisearch also returns this error if you set more than 200 header fields for a single webhook.
+
+### `invalid_webhook_uuid`
+
+The provided webhook `uuid` is not a valid uuid v4 value.
+
 ## `io_error`
 
 This error generally occurs when the host system has no space left on the device or when the database doesn't have read or write access.
@@ -726,3 +754,7 @@ The remote instance answered with `500 INTERNAL ERROR`.
 ### `remote_timeout`
 
 The proxy did not answer in the allocated time.
+
+### `webhook_not_found`
+
+The provided webhook `uuid` does not correspond to any configured webhooks in the instance.