Sign in

v29

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-233765161.7 KB
v1 projects

Create a new project

Create a new project for a user.

This endpoint:
- Creates a new project with the provided name and description
- Associates the project with the specified user_id, or the authenticated user if not provided
- The project will have access to user's preferences, episodes, and identity
- Returns the created project with all metadata

**Authentication**: Requires valid API key or JWT token
post/v1/projects

Request body

namestring required

Project name

descriptionstring nullable

Optional project description

user_idstring nullable

User ID to associate the project with. If not provided, uses the authenticated user's ID.

project_type'creative_design' | 'general'

Project type override. When set, skips LLM classification during content ingestion. Use 'creative_design' for artistic/design projects, 'general' for documentation/business content.

Example request

{
  "description": "A project for organizing research notes and findings",
  "name": "My Research Project",
  "project_type": "general",
  "user_id": "456e7890-e89b-12d3-a456-426614174001"
}

Response

Successful Response

messagestring required

Success message

Example response

{
  "message": "Project created successfully",
  "project": {
    "created_at": "2023-01-01T00:00:00Z",
    "description": "A project for organizing research notes",
    "name": "My Research Project",
    "project_id": "123e4567-e89b-12d3-a456-426614174000",
    "updated_at": "2023-01-01T00:00:00Z",
    "user_email": "john@example.com",
    "user_id": "456e7890-e89b-12d3-a456-426614174001",
    "user_name": "John Doe"
  }
}