Home / Docs / API Reference

API Reference

Coming Soon — Developer Preview

The Aamlaa REST API lets you programmatically generate code, manage projects, and interact with the Marketplace. Integrate AI code generation directly into your CI pipelines, toolchains, or products.

Base URL

https://api.aamlaa.com

Authentication: API requests use Bearer token authentication. Include your API key in the Authorization: Bearer <key> header. Generate API keys from Settings → API Keys (BYOK plan required).

Planned Endpoints

Method	Endpoint	Description	Auth
GET	/api/marketplace/templates	List all published Marketplace templates. Supports filtering by tag, projectType, and author.	Optional
GET	/api/marketplace/templates/:id	Retrieve a single template by ID, including its manifest, starterFiles, and stats.	Optional
POST	/api/projects	Create a new project from a prompt or template. Returns a project ID and initial generation state.	Required
GET	/api/projects/:id	Retrieve a project's current state, files, and version history.	Required
POST	/api/projects/:id/generate	Trigger a new generation on an existing project with an updated prompt or context.	Required
GET	/api/projects/:id/export	Export a project as a ZIP archive. Returns a signed download URL valid for 1 hour.	Required
POST	/api/projects/:id/deploy	Trigger a deployment to Cloudflare Pages. Returns a deployment URL and build status.	Required
GET	/api/models	List all available AI models, their capabilities, and rate-limit status for your account.	Required

All endpoints return JSON. Rate limits apply based on your plan. The API is versioned — all paths above are under v1.

Example response — GET /api/projects/:id

{
  "id": "proj_01hx9zk3j4abc",
  "name": "My SaaS App",
  "projectType": "fullstack",
  "status": "ready",
  "createdAt": "2026-04-01T12:00:00Z",
  "updatedAt": "2026-04-01T12:05:22Z",
  "files": {
    "src/app/page.tsx": "...",
    "src/app/layout.tsx": "...",
    "package.json": "..."
  },
  "versions": [
    { "id": "v1", "createdAt": "2026-04-01T12:00:00Z" },
    { "id": "v2", "createdAt": "2026-04-01T12:05:22Z" }
  ]
}

Get API access when it launches

Sign up for a BYOK account to be first in line for the developer preview. We'll send API credentials directly to your inbox.