# Create a draft partner app

**POST /v1/admin/orgs/{org_id}/partner-apps**

Create a new partner app in DRAFT status.

Top-level slugs are globally unique (the slug is the public tenant
identifier baked into ChatGPT connector URLs). Brand sub-page slugs
are unique per parent. Either collision returns 409.

Phase-3 quotas + tombstone enforcement: per-org partner-app caps
surface as 429; archived-slug cooldown surfaces as 409 with a
cooldown-aware message.

When ``?copy_from=<app-id>`` is supplied, the new app inherits the
source's draft JSONB blobs verbatim (with tool names cleared per
G3-35b). Versions are NOT copied — the new app starts at DRAFT.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Http bearer


## Parameters

### Path parameters

- **org_id** (string)


### Query parameters

- **copy_from** (string | null)
  Source partner app id (G3-35b). When set, the new app's JSONB blobs (sections, theme, auth_config, sponsored_config) are cloned from the source's current draft state. Tool names are reset to empty strings. Slug uniqueness, tombstone cooldown, and per-org quotas all still apply to the new slug.


### Body: application/json (object)

- **slug** (string)
  URL slug. Will be normalized server-side to [a-z0-9-]+ with no leading/trailing hyphen. Reserved blocklist applies.

- **display_name** (string)

- **tagline** (string | null)

- **parent_app_id** (string | null)
  Set this for brand sub-pages; the parent app must exist and belong to the same org.

- **catalog_id** (string)
  Catalog UUID this app's capabilities will query.



## Responses
### 201
Successful Response

#### Body: application/json (object)
- **id** (string)

- **org_id** (string)

- **slug** (string)

- **parent_app_id** (string | null)

- **parent_slug** (string | null)

- **catalog_id** (string | null)

- **display_name** (string)

- **tagline** (string | null)

- **status** (string)
  Lifecycle states for a partner app row.

  Mirrors the ``partner_app_status`` Postgres enum created in the
  ``b3fb8189acb2_add_partner_apps_tables`` Alembic migration.

- **schema_version** (integer)

- **sections** (array[object] | null)

- **theme** (object | null)

- **sponsored_config** (object | null)

- **auth_config** (object | null)

- **created_at** (string(date-time))

- **updated_at** (string(date-time))

- **created_by** (string | null)

- **versions** (array[object])

- **latest_version** (object | null)

- **draft_revision** (string | null)

- **published_section_ids** (array[string])


### 422
Validation Error

#### Body: application/json (object)
- **detail** (array[object])



[Powered by Bump.sh](https://bump.sh)