Sign in
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"
  }
}

Changes

Changed in 4 of the 29 revisions of this API.27

  • bb6f89ac9cd323See the full diff
    • ▲

      request property project_type was restricted to a list of enum values

      request-property-became-enum

    • ▲

      request property project_type list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ○

      the project_type request property default value general was added

      request-property-default-value-added

    • ○

      added the new creative_design enum value to the request property project_type

      request-property-enum-value-added

    • ○

      added the new general enum value to the request property project_type

      request-property-enum-value-added

    This revision also has 20 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ad860831e5242See the full diff
    • ○

      added the new optional request property project_type

      new-optional-request-property

    • ○

      added the optional property project/project_type to the response with the 201 status

      response-optional-property-added

  • dbc0f4ca8e3d1See the full diff
    • ○

      added the new optional request property user_id

      new-optional-request-property

  • 1660d0b2cbd91See the full diff
    • ○

      endpoint added

      endpoint-added