Projects

The Projects API allows you to manage the high-level containers for all project artifacts. A project contains the original prompt, AI-generated summary, and acts as the parent for personas, features, and other assets.

The Project Object

Field	Type	Description
id	UUID	Unique identifier for the project.
name	string	The name of the project.
original_prompt	string	The initial prompt used to create the project.
current_prompt	string	The current version of the project prompt.
model	string	The AI model ID used for generation (e.g., gpt-4o).
status	string	One of draft, active, archived.
app_architecture_prefs	array	List of selected technical preferences (e.g., Next.js, Supabase).
created_at	string	ISO 8601 timestamp of creation.
updated_at	string	ISO 8601 timestamp of last update.

List Projects

GET /crud/projects

Retrieve a paginated list of your projects.

Query Parameters

Parameter	Type	Default	Description
limit	integer	100	Number of records to return.
offset	integer	0	Number of records to skip.
status	string	-	Filter by status (draft, active, archived).
search	string	-	Search term for project name or description.

Example Request

curl -X GET "https://vibemap.ai/api/crud/projects?limit=10&status=active" \
     -H "Authorization: Bearer YOUR_TOKEN"

Get a Project

GET /crud/projects?id={projectId}

Retrieve details for a specific project.

Query Parameters

Parameter	Type	Description
id	UUID	Required. The unique ID of the project.
includeAnalysis	boolean	If true, returns associated features, personas, and schema summary in an analysis field.

Example Request

curl -X GET "https://vibemap.ai/api/crud/projects?id=PROJECT_UUID&includeAnalysis=true" \
     -H "Authorization: Bearer YOUR_TOKEN"

Create a Project

POST /crud/projects

Create a new project.

Request Body

{
  "name": "My New App",
  "original_prompt": "I want to build a fitness tracking app...",
  "current_prompt": "I want to build a fitness tracking app...",
  "model": "gpt-4o",
  "status": "draft"
}

Example Request

curl -X POST "https://vibemap.ai/api/crud/projects" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Fitness Tracker",
       "original_prompt": "A simple mobile app to track daily runs.",
       "current_prompt": "A simple mobile app to track daily runs.",
       "model": "gpt-4o"
     }'

Update a Project

PUT /crud/projects?id={projectId}

Update an existing project.

Example Request

curl -X PUT "https://vibemap.ai/api/crud/projects?id=PROJECT_UUID" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "status": "active",
       "name": "Updated Project Name"
     }'

Delete a Project

DELETE /crud/projects?id={projectId}

Delete a specific project and all its associated artifacts.

Example Request

curl -X DELETE "https://vibemap.ai/api/crud/projects?id=PROJECT_UUID" \
     -H "Authorization: Bearer YOUR_TOKEN"

Batch Operations

The Projects API supports batch creation, updates, and deletions.

Batch Create

POST /crud/projects

{
  "operation": "create",
  "projects": [
    { "data": { "name": "Project 1", "original_prompt": "...", "current_prompt": "..." } },
    { "data": { "name": "Project 2", "original_prompt": "...", "current_prompt": "..." } }
  ]
}

Batch Update

PUT /crud/projects

{
  "operation": "update",
  "projects": [
    { "id": "UUID_1", "data": { "status": "active" } },
    { "id": "UUID_2", "data": { "status": "archived" } }
  ]
}

Batch Delete

DELETE /crud/projects

{
  "operation": "delete",
  "projectIds": ["UUID_1", "UUID_2"]
}