Skip to main content
POST
Preview feed posts from draft persona

Authorizations

Authorization
string
header
required

User JWT access token issued by POST /api/auth/verify or POST /api/auth/social/verify. Routes that accept both auth modes declare api-key and bearer-jwt security schemes.

Headers

x-signature
string

HMAC-SHA256 signature: HMAC-SHA256(secretKey, timestamp + METHOD + path + body). Required for API-key authenticated requests (JWT/OAuth session auth is exempt).

x-timestamp
string

Request timestamp in epoch milliseconds. Required with x-signature for API-key auth. Rejected if drift exceeds 5 minutes.

Path Parameters

id
string
required

Body

application/json
persona
string
voice
string
examples
string
bannedWords
string
style
string

Optional BotStyle preset (FRIENDLY, CYNICAL, etc.). Used as the persona base when no custom persona is published.

Example:

"FRIENDLY"

scenarios
object[]

Optional mock scenarios. When omitted, seven built-in sample events are used. Nothing is saved to the activity feed.

Response

Sample posts for each writer prompt.

success
boolean
required
Example:

true

data
object
required

Endpoint-specific payload