docs(iam): add troubleshooting for API key and permissions issues

Author: SamyOubouaziz

menu/navigation.json

@@ -433,6 +433,16 @@
                 "label": "API/CLI",
                 "slug": "api-cli"
               },
+              {
+                "items": [
+                  {
+                    "label": "I cannot use Scaleway resources using the API",
+                    "slug": "cannot-use-resources-using-api"
+                  }
+                ],
+                "label": "Troubleshooting",
+                "slug": "troubleshooting"
+              },
               {
                 "label": "Videos",
                 "slug": "videos"

pages/iam/troubleshooting/cannot-use-resources-using-api.mdx

@@ -0,0 +1,58 @@
+---
+meta:
+  title: I cannot use Scaleway resources
+  description: Fix issues encountered while interacting with Scaleway resources and products using the console or API.
+content:
+  h1: I cannot use Scaleway resources
+  paragraph: Fix issues encountered while interacting with Scaleway resources and products using the console or API.
+tags: api 403 error unable connection fail product resource api cli developer tools
+dates:
+  validation: 2025-01-30
+  posted: 2025-01-30
+categories:
+  - iam
+---
+ 
+<Macro id="requirements" />
+
+- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+
+## Problem
+
+When interacting with Scaleway resources using the Scaleway console, API, CLI, or any other developer tools, you encounter one of the following issues:
+
+- a message saying **Insufficient permissions** displays
+- a message saying **Access Denied** displays
+- a `403` error displays
+- No output displays when interacting with Scaleway products using a command-line tool, and no changes appear in the Scaleway console
+
+## Cause
+
+You (or the IAM [user](/iam/concepts/#user) or [application](/iam/concepts/#application)) may not have the correct appropriate [IAM permissions](/iam/how-to/view-permission-sets/) to perform the desired actions. 
+
+## Solution
+
+1. Make sure that you are using a valid [API key](https://console.scaleway.com/iam/api-keys).
+
+2. Make sure that the bearer of the API key (IAM [user](/iam/concepts/#user) or [application](/iam/concepts/#application)) has the appropriate [IAM permissions](/iam/how-to/view-permission-sets/) to perform the desired actions.
+
+3. If you **do not** have [Owner](/iam/concepts/#owner) status for the organization in which you are trying to perform actions, contact the IAM manager or owner of this organization.
+
+4. If your are using a command-line tool to interact with Scaleway resources, make sure that there is no environment variable overriding your API key. Refer to the [documentation on environment variables priority](/scaleway-cli/reference-content/environment-variables/#environment-variables-priority) for more information.
+
+<Message type="note">
+If you encounter issues while using Object Storage, refer to the [dedicated troubleshooting page](/object-storage/troubleshooting/api-key-does-not-work/).
+</Message>
+
+## Going further
+
+- If you did not manage to identify the error and solve it by yourself, [open a support ticket](/account/how-to/open-a-support-ticket/), and provide as many details as possible, along with the necessary information below:
+    - Organization ID
+    - Project ID
+    - Resource type and ID
+    - Request type (PUT, GET, etc.)
+    - HTTP status code
+    - Date and time (timestamp)
+    - User-agent (SDK, client, console, etc.)
+    - Transaction ID (if possible)
+    - Log / trace of the error (if possible)