List announcements
Needs the experts:read scope. A key without it gets 403 insufficient_scope. Routes not in this reference cannot be called with a key at all (403 not_available_to_api_keys).
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
id
The expert id.
Response
OK
id
A UUID.
agentId
A UUID.
title
body
ctaLabel
audience
Who sees it (every rule present must hold; {} is everyone): { traits?: [{ key, op, value? }], plans?: [..], seen?: [custom event names], notSeen?: [..] }. op: eq, neq, in, not_in, exists, not_exists, contains, gt, lt.
startsAt
isActive
createdAt
updatedAt
guideId
frequency
How often one person sees it; absent means at most 3 times, 24 hours apart. Never again once clicked or dismissed.
endsAt
Errors
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error