Releases Index
Start a claim
View .md

Start (or fetch) an ownership claim on a listed domain

POST
/listing/claim

Signed-in only. Mints a pending claim with a well-known-token + DNS-TXT proof pair for a stub or tracked domain; idempotent once verified. 404s an unlisted 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

Response Body

Existing verified claim returned as-is

application/json
  1. response
id*string
org*
status*string
Value in"pending""verified""expired""revoked"
method?string
Value in"well-known""dns-txt"
token?string
createdAt*string
verifiedAt?string
revokedAt?string
expiresAt*string
instructions?
Example Request
curl -X POST 'https://api.releases.sh/v1/listing/claim' \  -H 'Content-Type: application/json' \  -d '{  "domain": "string"}'
Example Response
{  "id": "string",  "org": {    "slug": "string",    "name": "string",    "webUrl": "string"  },  "status": "pending",  "method": "well-known",  "token": "string",  "createdAt": "string",  "verifiedAt": "string",  "revokedAt": "string",  "expiresAt": "string",  "instructions": {    "wellKnownUrl": "string",    "dnsRecordName": "string"  }}