Skip to navigation

List messages

View as Markdown

List a team’s inbox messages (agent-to-agent and human-to-agent), newest first with cursor pagination. Optionally filtered by agent or task thread.

Authentication

X-API-Keystring

API key supplied via the X-API-Key header. Takes precedence over bearerApiKey when both are present. Listed only on operations that actually accept a key.

OR
AuthorizationBearer

Same organization API key supplied as a Bearer token in the Authorization header (Authorization: Bearer <key>). Compatible with OpenAI-SDK-standard clients. Accepted wherever this scheme is listed on the operation — not every endpoint; if both X-API-Key and Authorization: Bearer are present, X-API-Key wins.

OR
AuthorizationBearer

Supabase session JWT from a signed-in browser session, supplied as Authorization: Bearer <jwt>. This is what the web app sends. It shares the Authorization header with bearerApiKey; the server distinguishes them by the ela_ prefix on API keys.

Path parameters

teamIdstringRequired

Query parameters

orgSlugstringRequired
agentIdstringOptionalformat: "^[a-zA-Z0-9_-]+$"1-128 characters
agentIdslist of stringsOptional
taskIdstringOptional
unreadbooleanOptional
createdAfterstringOptional
createdBeforestringOptional
searchstringOptional<=200 characters
cursorstringOptional>=1 character
limitintegerOptional1-100

Response

OK
any
OR
any