Add high-priority ticket for .mintignore documentation and API error

guides/automate-agent.mdx

@@ -1,20 +1,24 @@
 ---
 title: "Tutorial: Auto-update documentation when code is changed"
 sidebarTitle: "Automate documentation updates"
 description: "Use the agent API to automatically update your documentation."
 keywords: ["agent automation", "n8n", "GitHub Actions", "automatic doc updates"]
 ---
 
+<Warning>
+**Known issue**: Document `.mintignore` feature - agent encountered `AI_APICallError: Bad Request` when listing files from external repository. Reference: Slack thread #C03SJRBUH8X (reported by @U094K8T8423, @U07UV85Q5QU, @U094WVDUF7F).
+</Warning>
+
 ## What you will build
 
 An automation that updates your documentation when code is pushed to your main branch. The workflow can be built on multiple platforms, including GitHub Actions and n8n. It watches your code repository and then calls the agent API to update your documentation in a separate documentation repository.
 
 This workflow connects two separate repositories:
 
 - **Code repository**: Where you store application code. You'll set up the automation trigger on this repository. Examples include a backend API, frontend app, SDK, or CLI tool.
 - **Documentation repository**: Where you store your documentation and connect to your Mintlify project. The agent creates pull requests with documentation updates in this repository.
 
 This tutorial assumes your documentation is in a separate repository from your application code. If you have a monorepo, modify the workflow to target the directory where you store your documentation.
 
 ### Workflow overview
 
@@ -41,14 +45,14 @@
 
 ### Install the Mintlify app on your code repository
 
 The Mintlify app must be installed on your code repository so the agent can fetch context from your codebase. To add the app to new repositories:
 
 1. Navigate to the [Agent](https://dashboard.mintlify.com/products/agent) page in your Mintlify dashboard.
 2. Click **Add to new organization**. This will take you to the app installation page on GitHub.
 3. Select the repositories you want to grant access to from the list.
 4. Save your changes.
 
 ### Get your admin API key
 
 1. Navigate to the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard.
 2. Select **Create Admin API Key**.
@@ -148,8 +152,8 @@
 1. In your code repository, go to **Settings** → **Secrets and variables** → **Actions**.
 2. Click **New repository secret**.
 3. Add the following secrets:
    - Name: `MINTLIFY_API_KEY`, Secret: Your Mintlify admin API key
    - Name: `MINTLIFY_PROJECT_ID`, Secret: Your Mintlify project ID (found on the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page of your dashboard)
 
 For more information, see [Using secrets in GitHub Actions](https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets) in the GitHub documentation.
 
@@ -169,17 +173,17 @@
 ## Troubleshooting
 
 ### Workflow not running
 - Verify GitHub Actions is enabled in your code repository.
 - Check the **Actions** tab for error messages.
 - Ensure the workflow file is in `.github/workflows/` with a `.yml` extension.
 
 ### 401 error from agent API
 - Verify your API key starts with `mint_`.
 - Check the Authorization header is formatted as `Bearer mint_yourkey`.
 - Confirm the API key is for the correct Mintlify organization.
 
 ### No documentation updates appearing
 - Check that the documentation repository is connected to your Mintlify project.
 - Verify the agent has write access to the documentation repository.
 - Check the workflow logs for error messages from the agent.
 
@@ -194,20 +198,20 @@
 - n8n workspace
 - [Mintlify Pro or Custom plan](https://mintlify.com/pricing)
 - Mintlify app installed on your code repository
 - Mintlify admin API key
 - Admin access to the GitHub repositories for your code and documentation
 - GitHub personal access token
 
 ### Install the Mintlify app on your code repository
 
 The Mintlify app must be installed on your code repository so the agent can fetch context from your codebase. To add the app to new repositories:
 
 1. Navigate to the [Agent](https://dashboard.mintlify.com/products/agent) page in your Mintlify dashboard.
 2. Click **Add to new organization**. This will take you to the app installation page on GitHub.
 3. Select the repositories you want to grant access to from the list.
 4. Save your changes.
 
 ### Get your admin API key
 
 1. Navigate to the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard.
 2. Select **Create Admin API Key**.
@@ -218,11 +222,11 @@
 1. In GitHub, navigate to **Settings**.
 2. Click **Developer settings**.
 3. Click **Personal access tokens**.
 4. Click **Tokens (classic)**.
 5. Click **Generate new token (classic)**.
 6. Select these scopes:
    - `repo` (full control of private repositories)
    - `admin:repo_hook` (if you want n8n to create webhooks)
 7. Generate and save the token securely.
 
 For more information, see [Creating a personal access token (classic)](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens?versionId=free-pro-team%40latest&productId=account-and-profile#creating-a-personal-access-token-classic) in the GitHub documentation.
@@ -235,7 +239,7 @@
 2. Add a webhook node.
 3. Configure the webhook:
    - HTTP Method: `POST`
    - Path: `auto-update-documentation` (or any unique path)
    - Authentication: None
    - Respond: Immediately
 4. Save the workflow.
@@ -258,7 +262,7 @@
    - Payload URL: Paste your n8n webhook URL
    - Content type: `application/json`
    - Which events would you like to trigger this webhook?
        - Select **Let me select individual events.**
        - Select only **Push events**.
    - Select **Active**
 6. Click **Add webhook**.
@@ -314,7 +318,7 @@
    - Authentication: Generic Credential Type → Header Auth
        - Create a new credential:
            - Name: `Authorization`
            - Value: `Bearer mint_YOUR_API_KEY` (replace with your API key)
    - Send Body: On
    - Body Content Type: JSON
    - Specify Body: Using JSON
@@ -375,7 +379,7 @@
 
 ## Troubleshooting
 
 ### Webhook not triggering
 
 - Verify the workflow is active in n8n.
 - Check GitHub repository Settings → Webhooks → Recent Deliveries for the response code.
@@ -384,7 +388,7 @@
 ### 401 error from agent API
 
 - Verify your API key starts with `mint_`.
 - Check the Authorization header is formatted as `Bearer mint_yourkey`.
 - Confirm the API key is for the correct Mintlify organization.
 
 ### 401 error from GitHub