---
title: Self-serve promotion of a claimed stub org to tracked
description: >-
  Signed-in only, and the caller must hold a verified claim on the resolved org
  (403 otherwise).
---
# Self-serve promotion of a claimed stub org to tracked

`POST https://api.releases.sh/v1/listing/promote`

Signed-in only, and the caller must hold a verified claim on the resolved org (403 otherwise). Materializes stored release locators into sources — tier-1 (feed/github/appstore) go live, tier-2 (bare url/file) land paused for curator review — and flips the org to tracked. Idempotent: an already-tracked org is a no-op success. Gated behind a dedicated kill switch (creates live fetching sources).

**Auth:** Bearer token required.

**Request body** (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `domain` | string | yes |  |

**Responses**

- `200` Promotion result
- `400` Invalid request body
- `401` Sign-in required
- `403` No verified claim on this domain
- `404` Lane or promotion flag disabled, or the domain is not listed
- `409` Promotion already in progress for this org
- `429` Rate limited

Full request and response schemas: [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json).