---
title: "Create a new project"
method: POST
path: "/v1/projects"
tags: ["v1 projects"]
---

# Create a new project

`POST /v1/projects`

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

## Request body

- CreateProjectRequest — Request model for creating a new project
  - `name` string, required — Project name
  - `description` string, nullable — Optional project description
  - `user_id` string, 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.

## Response `201`

Successful Response

- CreateProjectResponse — Response model for creating a project
  - `project` ProjectResponse, required — Response model for project information
    - `project_id` string, required
    - `user_id` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `project_type` string, nullable — Project type override: 'creative_design' or 'general'. When set, skips LLM classification.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable, required
    - `user_name` string, nullable, required
    - `user_email` string, nullable, required
  - `message` string, required — Success message

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/elicitlabs/apis/elicit-labs-api.md) · [All operations](https://skmtc.net/elicitlabs/apis/elicit-labs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elicitlabs/elicit-labs-api/revisions/27701839a070/schema)