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.
idstringformat: "uuid"
organization_idstringformat: "uuid"
namestring
slugstring

Derived from name; unique within the organization.

descriptionstring
is_activeboolean
uses_organization_default_routingboolean

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

routing_policyobject or null

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

budget_configobject or null

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

created_atdatetime
updated_atdatetime

Errors

404
Not Found Error
422
Unprocessable Entity Error