Skip to navigation
Management APIProjects

Update Project

Update the fields you send. routing_policy replaces the project’s own policy in place, keeping its id; uses_organization_default_routing true deletes it. Setting is_active to false stops the project’s prompt injection, DLP and controls overrides applying; true restores them.

Authentication

AuthorizationBearer

A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.

Path parameters

project_idstringRequiredformat: "uuid"

The project’s id.

Request

This endpoint expects an object.
budget_configobject or nullOptional
Replaces the whole budget. null removes it.
descriptionstring or nullOptional
null clears it.
is_activebooleanOptional

false stops the project’s prompt injection, DLP and controls overrides applying; true restores them. Omit to keep the current value. null is rejected.

namestringOptional<=255 characters
Omit to keep the current value. null is rejected.
routing_policyobject or nullOptional
Replaces the project's routing policy, or creates one. null is the same as omitting it.
uses_organization_default_routingboolean or nullOptional

true deletes the project’s routing policy, so it routes with the organization default. false needs routing_policy. null is the same as omitting it.

Response

The updated project
budget_configobject or null

The project’s spending budget; null when it has none.

created_atdatetimeRead-only
When the project was created.
descriptionstring or null
What the project is for.
idstringRead-onlyformat: "uuid"
The project's id.
is_activeboolean
false while the project's prompt injection, DLP and controls overrides are switched off.
namestring
The project's name.
organization_idstringRead-onlyformat: "uuid"
The organization the project belongs to.
routing_policyobject or null

The project’s own routing policy; null when it uses the organization default.

slugstringRead-only
Derived from the name at creation and unique in the organization. It doesn't change when the project is renamed.
updated_atdatetimeRead-only
When the project last changed.
uses_organization_default_routingboolean
true when the project routes with the organization's default policy, having no policy of its own.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
502
Bad Gateway Error
503
Service Unavailable Error