Skip to main content

​
Overview

Creates a new project in your Bilt account. This is typically the first step in any app development workflow.
Projects are automatically associated with your API token’s user account.

​
Parameters

​
name
string
required
Project name. Must be unique within your account.
  • Max length: 255 characters
  • Format: Alphanumeric, hyphens, underscores
  • Example: "my-todo-app"
​
description
string
Human-readable project description.
  • Max length: 1000 characters
  • Example: "A simple todo list application with user authentication"
​
visibility
string
default:"PUBLIC"
Project visibility setting.
  • Options: "PUBLIC" or "PRIVATE"
  • Default: "PUBLIC"
  • PUBLIC: Visible to others, can be shared
  • PRIVATE: Only visible to you

​
Response

​
id
string
required
Unique project identifier (UUID format)
​
name
string
required
Project name as provided
​
description
string
Project description (null if not provided)
​
visibility
string
required
Project visibility: "public" or "private"
​
created_at
string
required
ISO 8601 timestamp of creation
​
updated_at
string
required
ISO 8601 timestamp of last update

​
Example Usage

{
  "name": "todo-app",
  "description": "A todo list with authentication and dark mode",
  "visibility": "PUBLIC"
}

​
Agent Workflow Example

1

Agent creates project

User: "Create a new project called 'landing-page'"

Agent uses bilt_create_project with:
{
  "name": "landing-page"
}
2

Agent receives project ID

{
  "id": "proj_abc123",
  "name": "landing-page",
  "visibility": "public"
}
3

Agent proceeds to build

Agent: "Created project 'landing-page' (proj_abc123). 
       Ready to start building. What features would you like?"

User: "Add a hero section, features grid, and contact form"

Agent uses bilt_send_message to build features...

​
Best Practices

Choose clear, specific project names that indicate the app’s purpose.✅ Good: "ecommerce-dashboard", "blog-cms", "todo-app"❌ Avoid: "test", "project1", "app"
Add descriptions when the project name alone doesn’t fully convey the scope.
{
  "name": "social-analytics",
  "description": "Social media analytics dashboard with real-time metrics, trend analysis, and competitor tracking"
}
Public projects are easier to share and showcase. Switch to PRIVATE only if needed.
Save the returned id for subsequent operations:
Created project: proj_abc123
Use this ID for all future operations on this project.

​
Error Handling

{
  "error": "Invalid request body",
  "details": {
    "name": "Name is required"
  }
}

​
Rate Limits

Limit10 projects created per hour

Total ProjectsUp to 100 active projects per account (free tier)
Contact support@bilt.me for higher limits on paid plans

bilt_list_projects

View all projects

bilt_get_project

Get project details

bilt_send_message

Start building

​
Next Steps

After creating a project:
  1. Get a session - Use bilt_get_session
  2. Send build instructions - Use bilt_send_message
  3. Monitor progress - Check status with bilt_get_messages
  4. Deploy - Send deployment message when ready