Archive (soft-delete) a project (admin)

DELETE

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

• Production
• Local

Soft-deletes (archives) the project. Guarded: the default project can never be archived, and a project with active resources cannot be archived.

Authorizations

• ClerkSession

Parameters

Path Parameters

org_id

required

string

project_id

required

string

Responses

200

Archived.

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

401

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

403

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

404

Resource not found.

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

409

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