API reference

Base URL https://frontables.vercel.app/api/v1. Authenticate with Authorization: Bearer fbk_….

GET/api/v1/me

Get current user

Returns the account that owns the API key, including plan and credit balance.

Request
curl https://frontables.vercel.app/api/v1/me \
  -H "Authorization: Bearer $FRONTABLES_API_KEY"
Response · 200
{
  "data": {
    "id": "clx…",
    "email": "you@example.com",
    "name": "Ada",
    "creditBalance": 942,
    "createdAt": "2026-11-18T10:00:00.000Z",
    "plan": "pro"
  }
}
GET/api/v1/models

List models

Lists enabled AI models and whether your plan can use each one.

Request
curl https://frontables.vercel.app/api/v1/models \
  -H "Authorization: Bearer $FRONTABLES_API_KEY"
Response · 200
{
  "data": [
    { "id": "mistralai/mistral-large-2512", "label": "Mistral Large 2512", "creditMultiplier": 1, "minPlan": "free", "available": true, "default": true }
  ]
}
GET/api/v1/projects

List projects

Lists non-archived projects you can access, newest first.

Parameters

  • pageinteger · query

    Page number, default 1.

  • pageSizeinteger · query

    1–50, default 20.

Request
curl https://frontables.vercel.app/api/v1/projects \
  -H "Authorization: Bearer $FRONTABLES_API_KEY"
Response · 200
{
  "data": {
    "items": [{ "id": "clx…", "name": "Launch page", "category": "landing", "starred": false, "archived": false, "createdAt": "…", "updatedAt": "…", "_count": { "files": 3 } }],
    "total": 1, "page": 1, "pageSize": 20, "pages": 1
  }
}
POST/api/v1/projects

Create project

Creates a project, optionally from a template. Counts against your plan's project limit.

Parameters

  • namestring · bodyrequired

    1–80 characters.

  • descriptionstring · body

    Up to 500 characters.

  • categorystring · body

    website | landing | webapp | dashboard | portfolio | ecommerce | other

  • templateSlugstring · body

    blank | saas-landing | portfolio | dashboard

Request
curl -X POST https://frontables.vercel.app/api/v1/projects \
  -H "Authorization: Bearer $FRONTABLES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Launch page", "category": "landing", "templateSlug": "saas-landing" }'
Response · 200
{ "data": { "id": "clx…", "name": "Launch page" } }
GET/api/v1/projects/{projectId}

Get project with files

Returns project metadata and the full content of every file.

Parameters

  • projectIdstring · pathrequired

    Project ID.

Request
curl https://frontables.vercel.app/api/v1/projects/$PROJECT_ID \
  -H "Authorization: Bearer $FRONTABLES_API_KEY"
Response · 200
{
  "data": {
    "id": "clx…", "name": "Launch page", "description": null, "category": "landing",
    "createdAt": "…", "updatedAt": "…",
    "files": [{ "path": "index.html", "content": "<!doctype html>…", "size": 2048, "updatedAt": "…" }]
  }
}
POST/api/v1/projects/{projectId}/generate

Run a generation

Sends a prompt to the AI, applies the generated file changes to the project and returns the result once complete (can take up to a few minutes). Consumes credits.

Parameters

  • projectIdstring · pathrequired

    Project ID.

  • promptstring · bodyrequired

    1–8000 characters.

  • modelstring · body

    Model ID from /api/v1/models. Defaults to the project or platform default.

Request
curl -X POST https://frontables.vercel.app/api/v1/projects/$PROJECT_ID/generate \
  -H "Authorization: Bearer $FRONTABLES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "Add a pricing section with three tiers", "model": "mistralai/codestral-2508" }'
Response · 200
{
  "data": {
    "messageId": "clx…",
    "message": "Added a pricing section…",
    "filesChanged": ["index.html", "styles.css"],
    "creditsCharged": 3,
    "creditBalance": 939,
    "usage": { "promptTokens": 2810, "completionTokens": 2950 }
  }
}
API reference · Developers · Frontables