Sites

List sites belonging to the authenticated principal.

Viewer numbers are plan-gated: on a plan without them each site comes back with metrics_locked: true and null view_count, unique_viewers and last_viewed_at, plus a boolean opened. The redaction is server-side, so an agent sees exactly what the dashboard does. Each site carries its client space (or null). Pages that expired or were deleted stay in this list rather than disappearing: check deleted_at before handing anyone a url, because a row with deleted_at set is a dead link that POST /sites/{idOrSlug}/restore can revive until restorable_until.

get/sites

Request

  • Base URL: https://api.stacktr.ee
  • URL: https://api.stacktr.ee/sites
  • 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, sites:read)

Query parameters

clientstring

Only sites filed under this client space (slug or name, case-insensitive).

limitinteger

Sites per page. Defaults to 200.

beforeinteger

Keyset cursor: pass next_before from the previous response. Send together with before_id.

before_idstring

Keyset cursor: pass next_before_id from the previous response. Send together with before.

Response

OK. Newest-updated first. When has_more is true, call again with before = next_before and before_id = next_before_id, and repeat until it is false.

has_moreboolean

More pages remain.

next_beforeinteger nullable

Cursor for the next page; null on the last page.

next_before_idstring nullable

Cursor for the next page; null on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.