API Reference

All API requests require authentication using a Bearer token:

curl -X GET https://api.buildeasy.dev/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY"

**Getting an API Key** 1. Go to Settings > API Keys 2. Click "Create New Key" 3. Copy and securely store your key

API keys have scopes that limit what they can access. Choose the minimum scopes needed for your use case.

**List Projects** ``` GET /v1/projects ```

**Create Project** ``` POST /v1/projects { "name": "My App", "description": "A task management application", "type": "web" } ```

**Get Project** ``` GET /v1/projects/:id ```

**Delete Project** ``` DELETE /v1/projects/:id ```

**Start Build** ``` POST /v1/projects/:id/builds { "prompt": "Add a dark mode toggle to the header" } ```

**Get Build Status** ``` GET /v1/builds/:id ```

**Cancel Build** ``` POST /v1/builds/:id/cancel ```

**List Build History** ``` GET /v1/projects/:id/builds ```

**Create Deployment** ``` POST /v1/projects/:id/deployments { "environment": "production" } ```

**Get Deployment** ``` GET /v1/deployments/:id ```

**List Deployments** ``` GET /v1/projects/:id/deployments ```

**Rollback Deployment** ``` POST /v1/deployments/:id/rollback ```