Management APIProjects

Create a project

Create a project, optionally with a project-scoped routing policy and a spending limit. Requires the manage_projects scope.

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.

Request

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

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

uses_organization_default_routingbooleanOptionalDefaults to true
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 created 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

422
Unprocessable Entity Error