TEASEDocs
API ReferenceInbox & Broadcasts

Suggested price for a fan

Returns a suggested pay-to-view price and spend tier for one fan, for use when composing an inbox message. Requires a read-scoped key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Query Parameters

fan_id*string

Identifier of the fan to price.

Length1 <= length <= 64

Response Body

application/json

application/json

GET
/api/admin/chatters/fan-pricing
curl -X GET "https://example.com/api/admin/chatters/fan-pricing?fan_id=string"
{  "fan_id": "fan_8841920",  "suggested_price_cents": 2000,  "tier": "whale"}
{  "detail": "Not authenticated"}

Compose a 1-on-1 inbox message

Queues a single direct message to one fan. Every outbound is screened and paced before delivery; live delivery is gated and currently runs in shadow mode (intent is recorded, nothing is delivered). The response status is 'sent', 'shadow', or 'blocked'. Requires a write-scoped key.

List fans waiting for a reply

Returns the live queue of fans awaiting a reply, longest wait first and higher-value fans prioritized. Requires a read-scoped key.