Get Messages

Return messages addressed to handle (or sent by it) with sent_at > since. Used by TandemApiTransport.sync() and eventually by MCP read_inbox / list_threads tools.

Auth scopes:

  • admin (X-Tandem-Api-Key): can query for any handle.
  • bearer (Authorization: Bearer <token>): can ONLY query for the handle the token is bound to. Prevents reading other users' mail.
get/v1/messages

Request

  • Base URL: https://www.tandem-cc.com (the document declares no server; this is the origin it was published from)
  • URL: https://www.tandem-cc.com/v1/messages
  • Auth: none declared

Query parameters

forstring required

Handle to fetch messages for

sincestring nullable

ISO 8601 timestamp; returns messages sent_at > this

limitinteger

Headers

X-Tandem-Api-Keystring nullable
Authorizationstring nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.