Skip to main content
POST
Get messages from multiple chats in bulk across the agency's creators (POST batch)
Required scopes
  • read:agency — Read agency information, including the agency’s team members.
  • read:chat — Read chat conversations, messages, and chat-related data. This includes viewing chat lists and message history.

Authorizations

Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Body

application/json
creators
object[]
required

Per-creator groups of chat UUIDs (1-25 creators)

Required array length: 1 - 25 elements

Response

Per-creator, per-chat messages or error. Always 200 when the request itself is valid, even if every key fails.

byCreator
object
required

Map of input creator UUID to its per-chat messages, or a creator-level error (forbidden/not_found).