diff --git a/pages/file-storage/faq.mdx b/pages/file-storage/faq.mdx
index 9a72dc66d8..7315106f6e 100644
--- a/pages/file-storage/faq.mdx
+++ b/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
diff --git a/pages/file-storage/how-to/attach-file-system.mdx b/pages/file-storage/how-to/attach-file-system.mdx
index c023c10135..f5ab635d74 100644
--- a/pages/file-storage/how-to/attach-file-system.mdx
+++ b/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.
+
+
+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).
+
+
+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//servers//attach-filesystem' \
+ -H "X-Auth-Token: $SCW_SECRET_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"filesystem_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.
+
+
+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).
+
+
+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= filesystem-id= 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.
\ No newline at end of file
diff --git a/pages/file-storage/quickstart.mdx b/pages/file-storage/quickstart.mdx
index f43e242e39..992e83c0a9 100644
--- a/pages/file-storage/quickstart.mdx
+++ b/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).
-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