Releases Index
Promote a listing
View .md

Self-serve promotion of a claimed stub org to tracked

POST
/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).

Authorization

bearerAuth
headerAuthorizationBearer <relk_… | relu_… | OAuth JWT>

Machine/operator tokens use the relk_ prefix; self-serve read-only user keys use relu_; Sign in with Releases supplies an OAuth access token. Required scope depends on the endpoint.

Request Body

application/json
  1. body
domain*string
Length1 <= length <= 255

Response Body

Promotion result

application/json
  1. response
promoted*boolean
alreadyTracked?boolean
sources*
locators*array<>
Example Request
curl -X POST 'https://api.releases.sh/v1/listing/promote' \  -H 'Content-Type: application/json' \  -d '{  "domain": "string"}'
Example Response
{  "promoted": true,  "alreadyTracked": true,  "sources": {    "created": 0,    "matched": 0  },  "locators": [    {      "locator": "string",      "outcome": "live"    }  ]}