Sign in

v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
projects

Update Project

Update a project's metadata.

Only provided fields will be updated. Project names must remain unique per team (the unique_active_project_name_per_team index): no two projects in the same team may share a name. User must be a member of the project's team.

patch/projects/{project_id}

Path parameters

project_idstring uuid required

Request body

namestring nullable

New name for the project

iconstring nullable

New icon identifier for the project

repostring nullable

New repository reference or URL

descriptionstring nullable

New project description

tagstring nullable

Short kebab-case label set by clustering agent

observationsstring nullable

Free-text agent notes about patterns observed

active_model_idstring nullable

Active model ID for inference

selected_model_idstring nullable

[Deprecated] Use active_model_id instead.

visibility'private' | 'team' nullable

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.