Reference

API Reference

The Rytora BuildLabs API lets you programmatically create projects, generate code, trigger deployments, and manage templates. All endpoints require authentication and a Pro plan subscription.

Pro plan required

API access is available exclusively on the Pro plan. Generate your API key from the Rytora BuildLabs dashboard under Settings > API Keys.

Authentication

All API requests require a Bearer token in the Authorization header. Generate your token from the Rytora BuildLabs dashboard.

Example request header

Authorization: Bearer sk_live_your_api_key_here

Base URL

https://api.buildlabs.rytora.ai/v1

Available endpoints

Projects

Method	Endpoint	Description
GET	`/api/v1/projects`	List all projects
POST	`/api/v1/projects`	Create a new project
GET	`/api/v1/projects/:id`	Get project details
PATCH	`/api/v1/projects/:id`	Update a project
DELETE	`/api/v1/projects/:id`	Delete a project

Generate

Method	Endpoint	Description
POST	`/api/v1/generate`	Generate code from a prompt
POST	`/api/v1/generate/iterate`	Iterate on existing code
GET	`/api/v1/generate/:id/status`	Check generation status

Deploy

Method	Endpoint	Description
POST	`/api/v1/deploy/vercel`	Deploy frontend to Vercel
POST	`/api/v1/deploy/railway`	Deploy to Supabase Hosting
GET	`/api/v1/deploy/:id/status`	Check deployment status

Templates

Method	Endpoint	Description
GET	`/api/v1/templates`	List available templates
GET	`/api/v1/templates/:id`	Get template details
POST	`/api/v1/projects/from-template`	Create project from template

Rate limits

API requests are rate-limited to ensure fair usage and platform stability. Exceeding the limit returns a 429 status code.

Endpoint	Limit
General API	100 requests/minute
Code generation	10 requests/minute
Deployment	5 requests/minute

Error responses

All errors follow a consistent JSON format with a status code, error type, and human-readable message.

Error response format

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid or expired API key"
}