latestOpenAPI 3.1.02026-08-19270462702.4 KB

b92f75fd3b61

projects

Update Project

Update a visible project.

Args: project_id: Project identifier. request: Partial update payload. auth: Authenticated caller. service: Project service.

Returns: Updated project.

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

Retired (ENG-5673). Omit it. Any non-null value is rejected with 422; a project's stored value cannot be changed.

routing_paramsobject nullable

Retired (ENG-5673). Omit it. Any non-empty value is rejected with 422 (the schema enforces this alongside a non-null router_type; a params-only patch is rejected one layer down by ProjectService.guard_router_write with the same 422).

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.