API reference
Base URL https://frontables.vercel.app/api/v1. Authenticate with Authorization: Bearer fbk_….
/api/v1/meGet current user
Returns the account that owns the API key, including plan and credit balance.
curl https://frontables.vercel.app/api/v1/me \ -H "Authorization: Bearer $FRONTABLES_API_KEY"
{
"data": {
"id": "clx…",
"email": "you@example.com",
"name": "Ada",
"creditBalance": 942,
"createdAt": "2026-11-18T10:00:00.000Z",
"plan": "pro"
}
}/api/v1/modelsList models
Lists enabled AI models and whether your plan can use each one.
curl https://frontables.vercel.app/api/v1/models \ -H "Authorization: Bearer $FRONTABLES_API_KEY"
{
"data": [
{ "id": "mistralai/mistral-large-2512", "label": "Mistral Large 2512", "creditMultiplier": 1, "minPlan": "free", "available": true, "default": true }
]
}/api/v1/projectsList projects
Lists non-archived projects you can access, newest first.
Parameters
pageinteger · queryPage number, default 1.
pageSizeinteger · query1–50, default 20.
curl https://frontables.vercel.app/api/v1/projects \ -H "Authorization: Bearer $FRONTABLES_API_KEY"
{
"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
}
}/api/v1/projectsCreate project
Creates a project, optionally from a template. Counts against your plan's project limit.
Parameters
namestring · bodyrequired1–80 characters.
descriptionstring · bodyUp to 500 characters.
categorystring · bodywebsite | landing | webapp | dashboard | portfolio | ecommerce | other
templateSlugstring · bodyblank | saas-landing | portfolio | dashboard
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" }'{ "data": { "id": "clx…", "name": "Launch page" } }/api/v1/projects/{projectId}Get project with files
Returns project metadata and the full content of every file.
Parameters
projectIdstring · pathrequiredProject ID.
curl https://frontables.vercel.app/api/v1/projects/$PROJECT_ID \ -H "Authorization: Bearer $FRONTABLES_API_KEY"
{
"data": {
"id": "clx…", "name": "Launch page", "description": null, "category": "landing",
"createdAt": "…", "updatedAt": "…",
"files": [{ "path": "index.html", "content": "<!doctype html>…", "size": 2048, "updatedAt": "…" }]
}
}/api/v1/projects/{projectId}/generateRun 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 · pathrequiredProject ID.
promptstring · bodyrequired1–8000 characters.
modelstring · bodyModel ID from /api/v1/models. Defaults to the project or platform default.
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" }'{
"data": {
"messageId": "clx…",
"message": "Added a pricing section…",
"filesChanged": ["index.html", "styles.css"],
"creditsCharged": 3,
"creditBalance": 939,
"usage": { "promptTokens": 2810, "completionTokens": 2950 }
}
}