Releases Index
Activate a listing
View .md

Activate an instant stub listing for an unlisted domain

POST
/listing/activate

Re-validates https://{domain}/.well-known/releases.json server-side, then creates a stub org (basis: declared) for an unlisted domain. Already-stub domains take no write except an optional tracking-request stamp; tracked domains 409 with the org pointer. Public and anonymous; rate limited per IP and per domain.

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
requestTracking?boolean

Response Body

Existing stub; tracking stamp updated

application/json
  1. response
activated*boolean
org*
trackingRequested*boolean
Example Request
curl -X POST 'https://api.releases.sh/v1/listing/activate' \  -H 'Content-Type: application/json' \  -d '{  "domain": "string"}'
Example Response
{  "activated": true,  "org": {    "slug": "string",    "name": "string",    "status": "stub",    "webUrl": "string"  },  "trackingRequested": true}