Sign in

v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
projects

Create Project

Create a new project for the authenticated user.

Delegates to ProjectService for business logic, example generation, activity recording, and failure analytics.

Args: request: Validated project creation payload. auth: Authentication result.

Returns: ProjectResponse for the newly created project.

Raises: HTTPException: 409 on duplicate name, 500 on unexpected errors.

post/projects

Request body

namestring required

Name for the project

iconstring

Icon identifier for the project

repostring nullable

Optional repository reference or URL

descriptionstring nullable

Optional project description

active_model_idstring nullable

Active model ID for inference

selected_model_idstring nullable

[Deprecated] Use active_model_id instead.

tagstring nullable

Short kebab-case label set by clustering agent

observationsstring nullable

Free-text agent notes about patterns observed

exampleobject nullable

Generated API example for the project

team_idstring nullable

Team ID to assign this project to. Defaults to the user's personal team when omitted.

visibility'private' | 'team'

Who can see this project: private (creator only) or team (all team members).

adaptive_cadence'off' | 'daily' | 'weekly' | 'monthly'

User-facing cadence preset for autonomous adaptive finetuning runs.

router_typestring nullable

When set, makes this project a router that selects a model per request. Must be a registered router id.

routing_paramsobject nullable

Router policy configuration; validated against the router_type schema.

Response

Successful Response

idstring required
user_idstring required
namestring required
iconstring
repostring nullable
descriptionstring nullable
active_model_idstring nullable
tagstring nullable
observationsstring nullable
exampleobject nullable
team_idstring required
visibilitystring
adaptive_cadence'off' | 'daily' | 'weekly' | 'monthly'

User-facing cadence preset for autonomous adaptive finetuning runs.

autonomy_enabledboolean
router_typestring nullable
routing_paramsobject
created_atstring required
updated_atstring required
selected_model_idstring nullable required

Deprecated alias for active_model_id -- kept for backward compat.