List contacts
The people Peeve knows about — signed-in users and anonymous visitors.
Credential: user token · Role: any (read)
Authorizations
A user token (pv_ut_…) as Authorization: Bearer pv_ut_…. X-Peeve-Key is accepted too. Never a query parameter — URLs end up in proxy logs and Referer headers.
The token carries its owner's live workspace role, re-read on every call.
Query Parameters
Page size. Over 200 is a 400, not a silent clamp.
1 <= x <= 200An opaque next_cursor from a previous page. Do not parse or construct it. Reusing a cursor under a different sort/order is rejected.
created_at, updated_at asc, desc user, visitor Exact lookup, resolved through the encrypted-email index. Never written to the audit log.
320Your own id for the user. Never written to the audit log.
300