Update a project

PATCH 
/api/v1/projects/:project_id

Updates a project's name, its attached guardrails (guardrail_ids — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (max_concurrent_runs), its continuation-chain ceiling (max_chain_generations), its orchestration nesting bound (max_run_depth), its inherited model route (default_model_route_id), its read-auditing opt-in (audit_reads_enabled), its trace-content retention window (trace_content_retention_days), and/or its zero-retention setting (trace_content_mode). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.

Request

Responses

200

Project updated successfully

400

Invalid request body

401

Unauthorized

403

Forbidden (non-admin user)

404

Project not found

409

default_model_route_id cannot be cleared while consumers inherit it (PROJECT_DEFAULT_ROUTE_INHERITED).