docs(fls): add CLI / API docs (#5734)

* docs(fls): add links to k8s doc

* docs(fls): add links to k8s doc

* docs(fls): add links to k8s doc

* docs(fls): update

* Update pages/file-storage/how-to/attach-file-system.mdx

Co-authored-by: Néda <[email protected]>

* Update pages/file-storage/quickstart.mdx

Co-authored-by: Néda <[email protected]>

* Update pages/file-storage/how-to/attach-file-system.mdx

Co-authored-by: Néda <[email protected]>

---------

Co-authored-by: Néda <[email protected]>

Author: SamyOubouaziz

pages/file-storage/faq.mdx

@@ -2,7 +2,7 @@
 title: File Storage FAQ
 description: Explore Scaleway File Storage with our comprehensive FAQ covering performance, persistence, and more.
 dates:
-  created: 2025-07-23
+  created: 2025-10-30
   validation: 2025-07-23
 category: storage
 productIcon: FileProductIcon

pages/file-storage/how-to/attach-file-system.mdx

@@ -6,7 +6,7 @@ categories:
   - storage
   - file-storage
 dates:
-  validation: 2025-07-23
+  validation: 2025-10-30
   posted: 2025-07-23
 ---
 
@@ -21,7 +21,7 @@ import Requirements from '@macros/iam/requirements.mdx'
 - [Created a file system](/file-storage/how-to/create-file-system/)
 - [Created at least one POP2 Instance](/instances/how-to/create-an-instance/)
 
-## How to attach a file system to an Instance
+## How to attach a file system using the Scaleway console
 
 1. Click **File Storage** in the **Storage** section of the side menu. A list of your file systems displays.
 
@@ -39,3 +39,41 @@ import Requirements from '@macros/iam/requirements.mdx'
 
 Your file system is now attached to the selected Instance(s) and can now be [mounted](/file-storage/how-to/mount-file-system/) to a Scaleway Instance.
 
+## How to attach a file system using the API
+
+The Scaleway API allows you to create and manage all your resources programmatically.
+
+<Message type="note">
+To attach a file system to an Instance, you must use the [Instance API](https://www.scaleway.com/en/developers/api/instances/#path-instances-attach-a-filesystem-volume-to-an-instance).
+</Message>
+
+1. Make sure you have [authenticated and performed your first request](https://www.scaleway.com/en/developers/api/#quickstart-first-request) with the Scaleway API.
+
+2. Run the cURL request below to attach your file system to the desired Instance. Remember to replace the placeholders with the appropriate values.
+
+    ```bash
+    curl -X POST 'https://api.scaleway.com/instance/v1/zones/<region>/servers/<instance-id>/attach-filesystem' \
+      -H "X-Auth-Token: $SCW_SECRET_KEY" \
+      -H "Content-Type: application/json" \
+      -d '{"filesystem_id": "<my-fs-id>"}'
+    ```
+
+Refer to the [Scaleway API documentation](https://www.scaleway.com/en/developers/api/instances/#path-instances-attach-a-filesystem-volume-to-an-instance) for more information on the different parameters.
+
+## How to attach a file system using the CLI
+
+Scaleway CLI is a tool to help you pilot your Scaleway infrastructure directly from your terminal.
+
+<Message type="note">
+To attach a file system to an Instance, you must use the [Instance CLI](https://cli.scaleway.com/instance/#attach-a-filesystem-volume-to-an-instance).
+</Message>
+
+1. Make sure you have [installed and configured the Scaleway CLI](/scaleway-cli/quickstart/).
+
+2. Run the command below to attach your file system to the desired Instance. Remember to replace the placeholders with the appropriate values.
+
+    ```bash
+    scw instance server attach-filesystem server-id=<instance_id> filesystem-id=<filesystem_id> zone=<availability_zone>
+    ```
+
+Refer to the [Scaleway CLI documentation](https://cli.scaleway.com/instance/#attach-a-filesystem-volume-to-an-instance) for more information on the different parameters.

pages/file-storage/quickstart.mdx

@@ -74,7 +74,9 @@ To attach a file system to an Instance, you must have [created at least one POP2
     File systems can only be attached to POP2 Instances within the same [region](/file-storage/concepts/#region).
     </Message>
 
-Your file system is now attached to the selected Instance(s) and can now be [mounted](/file-storage/how-to/mount-file-system/) to a Scaleway Instance.
+Your file system is now attached to the selected Instance(s) and can be [mounted](/file-storage/how-to/mount-file-system/) to a Scaleway Instance. 
+
+To attach a file system using the CLI or API, refer to the [dedicated documentation](/file-storage/how-to/attach-file-system/).
 
 ## How to mount a file system to a Scaleway Instance