PIpioneer
projects

Create Project

Changed on

Create a project.

Args: request: Creation payload. auth: Authenticated caller. service: Project service.

Returns: Created project.

Raises: HTTPException: 503 when a PostgreSQL statement timeout cancelled the insert, 500 for any other database failure.

post/v1/projects

Request

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 project label (e.g. web-navigation-agent). Set by whichever sandbox agent owns the project; the clustering agent that used to write it was deleted by ENG-6657.

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.

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
created_atstring required
updated_atstring required
selected_model_idstring nullable required

Deprecated alias for active_model_id -- kept for backward compat.

Changes