[Images] Webhooks and saturation parameter (#17742)

* Added saturation parameter

* Added configure webhooks & added links

* Apply suggestions from code review

Co-authored-by: Patricia Santa Ana <[email protected]>

---------

Co-authored-by: Patricia Santa Ana <[email protected]>

Author: 2 people

src/content/docs/images/manage-images/configure-webhooks.mdx

@@ -0,0 +1,20 @@
+---
+pcx_content_type: how-to
+title: Configure webhooks
+---
+
+You can set up webhooks to receive notifications about your upload workflow. This will send an HTTP POST request to a specified endpoint when an image either successfully uploads or fails to upload.
+
+Currently, webhooks are supported only for [direct creator uploads](/images/upload-images/direct-creator-upload/).
+
+To receive notifications for direct creator uploads:
+
+1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
+2. Go to **Notifications** > **Destinations**.
+3. From the Webhooks card, select **Create**.
+4. Enter information for your webhook and select **Save and Test**. The new webhook will appear in the **Webhooks** card and can be attached to notifications.
+5. Next, go to **Notifications** > **All Notifications** and select **Add**.
+6. Under the list of products, locate **Images** and select **Select**.
+7. Give your notification a name and optional description.
+8. Under the **Webhooks** field, select the webhook that you recently created.
+9. Select **Save**.

src/content/docs/images/transform-images/transform-via-url.mdx

@@ -111,6 +111,10 @@ You must specify at least one option. Options are comma-separated (spaces are no
 
 <Render file="rotate" />
 
+### `saturation`
+
+<Render file="saturation" />
+
 ### `sharpen`
 
 <Render file="sharpen" />

src/content/docs/images/transform-images/transform-via-workers.mdx

@@ -98,6 +98,10 @@ The `fetch()` function accepts parameters in the second argument inside the `{cf
 
 <Render file="rotate" />
 
+### `saturation`
+
+<Render file="saturation" />
+
 ### `sharpen`
 
 <Render file="sharpen" />

src/content/docs/images/upload-images/direct-creator-upload.mdx

@@ -1,13 +1,15 @@
 ---
 pcx_content_type: how-to
-title: Accept direct creator uploads
+title: Direct creator uploads
 sidebar:
   order: 5
 
 ---
 
 The Direct Creator Upload feature in Cloudflare Images lets your users upload images with a one-time upload URL without exposing your API key or token to the client. Using a direct creator upload also eliminates the need for an intermediary storage bucket and the storage/egress costs associated with it.
 
+You can set up [webhooks](/images/manage-images/configure-webhooks/) to receive notifications on your direct creator upload workflow.
+
 ## Request a one-time upload URL
 
 Make a `POST` request to the `direct_upload` endpoint using the example below as reference.

src/content/partials/images/saturation.mdx

@@ -0,0 +1,19 @@
+---
+{}
+---
+import { Tabs, TabItem } from "~/components"
+
+Increases saturation by a factor. A value of `1.0` equals no change, a value of `0.5` equals half saturation, and a value of `2.0` equals twice as saturated. `0` is ignored.
+
+<Tabs>
+  <TabItem label="URL format">
+    ```js 
+    saturation=0.5
+    ```
+  </TabItem>
+  <TabItem label="Workers">
+  ```js 
+  cf: {image: {saturation: 0.5}}
+  ```
+  </TabItem>
+</Tabs>