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.
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

422
Unprocessable Entity Error