Management APIProjects

Update a project

Update fields you send. routing_policy fully replaces the scoped policy in place (stable id); uses_organization_default_routing=true deletes it.

Authentication

AuthorizationBearer

A management key (prefixed mgmt_), created in the dashboard under Settings, API keys, Management keys. Distinct from a regular gateway API key, and never used to call models.

Path parameters

project_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
namestringOptional<=255 characters
descriptionstringOptional
is_activebooleanOptional
budget_configobjectOptional

Project spending limit. hard_limit rejects requests with HTTP 402 once reached; soft_limit alerts only.

uses_organization_default_routingbooleanOptional
routing_policyobjectOptional

Project-scoped routing policy. PRIORITY requires priority_order; INTELLIGENT requires allowed_models (allowed_providers is derived). The two field sets are mutually exclusive by strategy.

Response

The updated project.
idstringOptionalformat: "uuid"
organization_idstringOptionalformat: "uuid"
namestringOptional
slugstringOptional

Derived from name; unique within the organization.

descriptionstringOptional
is_activebooleanOptional
uses_organization_default_routingbooleanOptional

True when the project routes via the org default policy (no scoped policy).

routing_policyobject or nullOptional

The project’s scoped routing policy. The id is stable across updates (updates apply in place).

budget_configobject or nullOptional

Project spending limit. hard_limit rejects requests with HTTP 402 once reached; soft_limit alerts only.

created_atdatetimeOptional
updated_atdatetimeOptional

Errors

404
Not Found Error
422
Unprocessable Entity Error