External API Guide

Let AI assistants like ChatGPT, Claude, and Manus generate complete project structures in your FolderCopilot account

Quick Start (3 Steps)
1

Generate Token

Go to Settings → External AI Access → Generate AI Token

2

Use with AI

Share token with ChatGPT, Claude, or other AI assistant

3

Get Your Project

Find generated project in your FolderCopilot dashboard

Overview

The FolderCopilot External API allows AI assistants to programmatically generate complete project structures in your account. Simply provide your token to an AI assistant, describe your project, and let it create everything for you.

Endpoint:

POST https://www.foldercopilot.com/api/external/generate-boilerplate
Authentication

Tokens are short-lived (15 minutes) and automatically expire for security. Generate new tokens as needed from your Settings page.

Token Format

All tokens start with fc_ext_ followed by a random string

Include token in Authorization header:

Authorization: Bearer fc_ext_YOUR_TOKEN_HERE
Using with AI Assistants
Supported

ChatGPT

Example prompt:

"Using my FolderCopilot token fc_ext_[YOUR_TOKEN], create a complete Next.js 14 e-commerce application with Stripe payments, user authentication, product catalog, shopping cart, and admin dashboard. Include all necessary components, API routes, and database schemas."
Supported

Manus

Manus has full POST request capabilities and can directly call the FolderCopilot API. Simply provide your token and describe your project.

Limited

Claude

Claude can generate complete project structures and provide curl commands for you to execute. While Claude cannot directly POST to external APIs, it excels at creating comprehensive project architectures.

Code Examples
curl -X POST https://www.foldercopilot.com/api/external/generate-boilerplate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer fc_ext_YOUR_TOKEN_HERE" \
  -d '{
    "projectName": "my-nextjs-app",
    "description": "A Next.js project with authentication",
    "structure": {
      "folders": [
        "my-nextjs-app",
        "my-nextjs-app/src",
        "my-nextjs-app/src/app",
        "my-nextjs-app/src/components"
      ],
      "files": [
        {
          "path": "my-nextjs-app/package.json",
          "contents": "{\"name\": \"my-nextjs-app\", \"version\": \"0.1.0\"}"
        }
      ]
    }
  }'
Response Format

Success Response (200 OK):

{
  "success": true,
  "projectId": "wGDUC2N4benq878Kfb29i",
  "projectUrl": "https://www.foldercopilot.com/dashboard",
  "filesCreated": 23
}

Error Response:

{
  "success": false,
  "error": "Invalid or expired token",
  "code": "AUTH_ERROR"
}
Troubleshooting

401 Unauthorized

Token is invalid or expired

Solution: Generate a new token from Settings → External AI Access

400 Bad Request

Malformed JSON or missing required fields

Solution: Verify your JSON structure includes projectName and structure.folders/files

CORS Error (Browser)

Cannot make requests from browser artifacts

Solution: Use curl commands, server-side code, or AI assistants with POST capabilities

Best Practices
  • Be specific in project descriptions

    The more details you provide, the better the AI can structure your project

  • Generate new tokens frequently

    Tokens expire after 15 minutes for security - generate fresh ones as needed

  • Include comprehensive file structures

    Add README files, configuration files, and boilerplate code for better results

  • Don't share tokens publicly

    Anyone with your token can create projects in your account

Ready to Get Started?

Generate your first token and let AI assistants create amazing projects for you