Skip to content

Create a project in the org (admin)

POST
/v1/admin/orgs/{org_id}/projects

Create a project under the org. The org’s max_projects cap is enforced inside the same transaction as the create. Client ids are never accepted.

org_id
required
string

Create a project under the org. Enforced against the org’s max_projects cap inside the same transaction as the create. Client-supplied ids are never accepted; the server creates a UUID.

object
name
required
string
slug
string
description
string

Created.

An Extrovert project (the resource namespace inside an org). project ids are plain server-created UUIDs (never client-supplied).

object
id
required
string
org_id
required
string
customer_id
required
string
name
required
string
slug
required
string
description
required
string
is_default
required
boolean
lifecycle_status
required
string
Allowed values: active archived deleted
version
required

Optimistic-CAS version.

integer
created_at
required
string format: date-time
updated_at
required
string format: date-time

Invalid request.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Resource conflict (e.g. a duplicate entry).

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope