Skip to main content
POST
/
api
/
v1
/
projects
Create Project
curl --request POST \
  --url https://api.example.com/api/v1/projects \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "settings": {}
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": {},
  "settings": {},
  "active_export_id": {},
  "created_at": "<string>",
  "VALIDATION_ERROR": {},
  "UNAUTHORIZED": {}
}

​
Overview

Creates a new project. A project is the container that holds chapters, prompts, and exports.

​
Request

​
Headers

​
Authorization
string
required
Bearer token with your API key
​
Content-Type
string
required
Must be application/json

​
Body

​
name
string
required
Project name (1-30 characters)
​
description
string
Optional project description (max 1000 characters)
​
settings
object
Optional project settings (reserved for future use)

​
Response

​
id
string
Unique project identifier (format: prj_[A-Za-z0-9]{21})
​
name
string
Project name
​
description
string | null
Project description
​
settings
object | null
Project settings
​
active_export_id
string | null
ID of the currently active export, if any
​
created_at
string
ISO 8601 timestamp when the project was created

​
Examples

curl -X POST https://api.babou.ai/api/v1/projects \
  -H "Authorization: Bearer $BABOU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pricing Page Refresh",
    "description": "Launch campaign for the new Team tier"
  }'

​
Response Example

{
  "id": "prj_abc123xyz",
  "name": "Pricing Page Refresh",
  "description": "Launch campaign for the new Team tier",
  "settings": null,
  "active_export_id": null,
  "created_at": "2025-12-02T10:00:00Z"
}

​
Error Responses

​
VALIDATION_ERROR
400
Invalid request parameters
{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "hint": "Name must be between 1 and 30 characters"
}
​
UNAUTHORIZED
401
Invalid or missing API key
{
  "error": "Unauthorized - Invalid API key",
  "code": "UNAUTHORIZED"
}

​
Next Steps

Add Chapters

Add chapters to your project

List Projects

View all your projects