Skip to main content
GET
List top-level opinions of a topic

Authorizations

Authorization
string
header
required

Personal API key issued per SeeSaw user account: Authorization: Bearer sspat_…. Manage keys on the app API (/v1/users/me/api-keys). Revocation propagates within ~60 seconds (validation cache window).

The key's scopes decide what it may do: every key has read; a key created with ["read","write"] may also use the six write operations (marked x-required-scope: write in this document). Scopes are fixed at creation — to gain write access, create a new key. A read-only key calling a write operation gets 403 FORBIDDEN_SCOPE.

Path Parameters

id
string<uuid>
required

Topic UUID.

Query Parameters

cursor
string

Opaque pagination cursor from a previous response's next_cursor.

limit
integer
default:20

Page size (max 100).

Required range: 1 <= x <= 100

Response

Opinions, newest first

Uniform list shape. next_cursor is null on the last page.

data
object[]
required
next_cursor
string | null
required
has_more
boolean
required