Sites

Claim an anonymous site into your account.

Adopt an anonymously-published site (no account, 24h TTL) into the authenticated account using the single-use claim_token returned at publish time. Single-use, and only while the site is still unowned and unexpired. A claim is a publish: it counts against the plan's page cap, and the page is given the longest life that plan allows: permanent on a paid plan, 7 days from now on Free. A claimed page keeps its passcode on every plan; the response expires_at is authoritative for what the page actually got.

post/sites/{idOrSlug}/claim

Request

  • Base URL: https://api.stacktr.ee
  • URL: https://api.stacktr.ee/sites/{idOrSlug}/claim
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.stacktr.ee/oauth/authorize, token URL https://api.stacktr.ee/oauth/token, scopes: sites:write)

Request body

claim_tokenstring required

The secret claim token from the publish response.

viastring

Optional: the surface that sent the claimer here (the via on the claim link). Analytics only.

Response

Claimed.

okboolean
idstring
expires_atinteger nullable

Unix epoch seconds after the plan ceiling was applied; null = permanent.

Changes