curl -X POST https://api.initrepo.com/v1/projects \
-H "Authorization: Bearer ir_live_your_api_key" \
-H "Content-Type: application/json" \
-H "API-Version: v1.0" \
-d '{
"projectIdea": "Build a modern e-commerce platform with AI recommendations",
"projectType": "web",
"features": [
{
"name": "Product Catalog",
"description": "Display products with search and filtering capabilities"
},
{
"name": "Shopping Cart",
"description": "Add/remove items, calculate totals, apply discounts"
}
],
"integrations": ["stripe", "sendgrid"],
"format": "full",
"webhookUrl": "https://your-app.com/webhooks/initrepo",
"design": {
"description": "Modern, clean design with dark mode support",
"figmaUrl": "https://figma.com/design/your-design-link"
}
}'
{
"success": true,
"data": {
"projectId": "550e8400-e29b-41d4-a716-446655440000",
"status": "in_progress",
"estimatedCompletionMs": 180000
}
}
HTTP/1.1 202 Accepted
API-Version: v1.0
API-Supported-Versions: v1.0
API-Latest-Version: v1.0
X-Request-ID: req_1234567890
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1699123456
Endpoints
Create Project
Creates a new project for AI-powered generation. This is an asynchronous operation.
POST
/
api
/
v1
/
projects
curl -X POST https://api.initrepo.com/v1/projects \
-H "Authorization: Bearer ir_live_your_api_key" \
-H "Content-Type: application/json" \
-H "API-Version: v1.0" \
-d '{
"projectIdea": "Build a modern e-commerce platform with AI recommendations",
"projectType": "web",
"features": [
{
"name": "Product Catalog",
"description": "Display products with search and filtering capabilities"
},
{
"name": "Shopping Cart",
"description": "Add/remove items, calculate totals, apply discounts"
}
],
"integrations": ["stripe", "sendgrid"],
"format": "full",
"webhookUrl": "https://your-app.com/webhooks/initrepo",
"design": {
"description": "Modern, clean design with dark mode support",
"figmaUrl": "https://figma.com/design/your-design-link"
}
}'
{
"success": true,
"data": {
"projectId": "550e8400-e29b-41d4-a716-446655440000",
"status": "in_progress",
"estimatedCompletionMs": 180000
}
}
HTTP/1.1 202 Accepted
API-Version: v1.0
API-Supported-Versions: v1.0
API-Latest-Version: v1.0
X-Request-ID: req_1234567890
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1699123456
Create a new project for AI-powered generation. This endpoint initiates an asynchronous process that generates comprehensive project documentation.
Request
curl -X POST https://api.initrepo.com/v1/projects \
-H "Authorization: Bearer ir_live_your_api_key" \
-H "Content-Type: application/json" \
-H "API-Version: v1.0" \
-d '{
"projectIdea": "Build a modern e-commerce platform with AI recommendations",
"projectType": "web",
"features": [
{
"name": "Product Catalog",
"description": "Display products with search and filtering capabilities"
},
{
"name": "Shopping Cart",
"description": "Add/remove items, calculate totals, apply discounts"
}
],
"integrations": ["stripe", "sendgrid"],
"format": "full",
"webhookUrl": "https://your-app.com/webhooks/initrepo",
"design": {
"description": "Modern, clean design with dark mode support",
"figmaUrl": "https://figma.com/design/your-design-link"
}
}'
Request Body
string
required
Project description (10-1000 characters). Should clearly describe what you want to build.
enum
required
Type of project to create. Options:
web, mobile, mcp.array
Array of project features (max 20). Each feature should have a
name and description.array
Array of integration names (max 10). Valid integrations include payment processors, email services, etc.
enum
default:"full"
Response format level. Options:
full, summary, minimal.string
HTTPS webhook URL for completion notifications. Must be HTTPS and not a private IP.
object
Design requirements including description and Figma links.
Response
{
"success": true,
"data": {
"projectId": "550e8400-e29b-41d4-a716-446655440000",
"status": "in_progress",
"estimatedCompletionMs": 180000
}
}
Response Headers:
HTTP/1.1 202 Accepted
API-Version: v1.0
API-Supported-Versions: v1.0
API-Latest-Version: v1.0
X-Request-ID: req_1234567890
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1699123456
boolean
Indicates if the request was successful.
string
Unique identifier for the created project.
string
Current status of the project (always “in_progress” for new projects).
integer
Estimated time in milliseconds until project completion.
Error Responses
Validation Error (422)
Authentication Error (401)
Insufficient Credits (402)
Rate Limit Exceeded (429)
Rate Limits
This endpoint is rate limited to 100 requests per minute per API key.Cost
This operation consumes 15,000 credits for live keys. Test keys consume no credits.Authorizations
Bearer token authentication using API keys (ir_live_* or ir_test_*)
Body
application/json
Project description (10-1000 characters)
Required string length:
10 - 1000Example:
"Build a modern e-commerce platform with AI recommendations"
Type of project to create
Available options:
web, mobile, mcp Example:
"web"
Array of project features (optional)
Maximum array length:
20Show child attributes
Show child attributes
Array of integration names (optional)
Maximum array length:
10Example:
["stripe", "sendgrid"]
Response format level
Available options:
full, summary, minimal Example:
"full"
HTTPS webhook URL for completion notifications (optional)
Pattern:
^https://Example:
"https://your-app.com/webhooks/initrepo"
Design requirements (optional)
Show child attributes
Show child attributes