Add first draft to document aep filtering

Author: val--

content/event-platform/available-filters.md

@@ -0,0 +1,67 @@
+# Event Filters
+
+Event filters let you **narrow down the events** sent to your destination by applying simple matching rules. They’re useful when you're only interested in specific types of changes—like ignoring automated updates or focusing on certain attributes.
+
+**Filters are optional**: if no filter is defined, your subscription will receive **all events** matching its type and source.
+
+Filters are defined when configuring [your subscription](/event-platform/concepts.html) and are automatically evaluated during event routing.
+
+> ⚠️ **Note:** For now, only **one filter** can be configured per subscription. Combining multiple filters (e.g., filtering by both user and attribute) is not yet supported.
+
+---
+
+## `user` *(available)*
+
+Use this filter to receive only events triggered by a specific user.
+
+- **Syntax**
+  `user=user_identifier`
+- **Parameters**
+    - `user_identifier`: The UUID of the user who authored the event.
+
+- **Example**
+  `user=57616f6f-1a4d-490e-bc23-c5877d2b30d9`
+
+---
+
+## `attribute` *(available soon)*
+
+Use this filter to receive only delta events where a specific attribute was updated.
+
+- **Syntax**
+  `attribute=attribute_code`
+- **Parameters**
+    - `attribute_code`: The code of the attribute you want to track.
+
+- **Example**
+  `attribute=short_description`
+
+---
+
+## `scope` *(available soon)*
+
+Use this filter to receive only delta events related to a specific scope.
+
+- **Syntax**
+  `scope=scope_code`
+- **Parameters**
+    - `scope_code`: The scope code of the updated data.
+
+- **Example**
+  `scope=my_scope`
+
+---
+
+## `locale` *(available soon)*
+
+Use this filter to receive only delta events for a specific locale.
+
+- **Syntax**
+  `locale=locale_code`
+- **Parameters**
+    - `locale_code`: The locale code of the updated data.
+
+- **Example**
+  `locale=en_US`
+
+---

content/event-platform/concepts.md

@@ -173,6 +173,41 @@ We currently use a static IP address provided by Google Cloud: `34.140.80.128`
 
 **However, we cannot guarantee that this IP address will remain unchanged indefinitely.** Therefore, we strongly recommend whitelisting the `europe-west1` IP ranges from [Google Cloud's IP ranges list](https://www.gstatic.com/ipranges/cloud.json) to ensure continuous access.
 
+## Subscriptions Filters
+
+When configuring a subscription, you can optionally define a **filter** to receive **only the events that match specific criteria**.
+
+Here's the available filters you can use:
+- user
+
+The following filters will be available soon:
+- attribute
+- scope
+- locale
+
+In the future, additional filters and advanced conditions (such as combining multiple filters with `AND` or `OR` operators) will become available.
+
+You can find the list of currently available filters and the correct syntax to use [here](/event-platform/available-filters.html).
+
+### Example
+Let’s say you want to receive only the events triggered by a specific user, identified by the UUID `ea0fe94f-417e-4078-a40b-38645ba90ebe`.
+You can configure your subscription with the following filter:
+
+```json[snippet:Filtered subscription]
+{
+  "source": "pim",
+  "subject": "https://my-pim.cloud.akeneo.com",
+  "events": [
+    "com.akeneo.pim.v1.product.updated"
+  ],
+  "type": "https",
+  "config": {
+    "url": "https://your_webhook_url",
+  }
+  "filter": "user=ea0fe94f-417e-4078-a40b-38645ba90ebe"
+}
+```
+
 ## Events Format
 
 Our platform standardises event data across services using the [CloudEvents specification](https://github.com/cloudevents/spec). CloudEvents provides a consistent structure for event data, ensuring interoperability and simplifying event handling. Each event includes essential metadata such as the event type, source, ID, and timestamp.
@@ -220,4 +255,4 @@ Example of an event payload for a productDeleted event
 For more information, consult the [CloudEvents spec attributes](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md).
 
 ::: panel-link Authorization and authentication requirements [Next](/event-platform/authentication-and-authorization.html)
-:::
+:::

src/partials/layout.handlebars

@@ -151,6 +151,11 @@ height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
                                 <li><a href="/event-platform/available-events.html">Available events</a></li>
                             </ul>
                         </li>
+                        <li>
+                            <ul>
+                                <li><a href="/event-platform/available-filters.html">Available filters</a></li>
+                            </ul>
+                        </li>
                       <!--
                       <li>
                           <ul>