List conversations, or the messages in one

Each application is one conversation between the member who applied and the member who posted the task; the inbox holds both kinds, each with the caller's role (poster or applicant). Without application_id, the inbox: every waiting or hired application (messages or not, so either side can write first) plus closed conversations that have messages, most recent activity first, with unread counts. With application_id, that conversation and its messages oldest first, a page at a time; the other side's messages are marked read. Same as the list_messages MCP tool.

get/api/messages

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/messages
  • Auth
    • HTTP bearer
    • or API key in cookie better-auth.session_token

Query parameters

application_idstring

The application id: id from list_my_applications (the human's own applications) or list_task_applications (applications to their tasks), or applicationId from list_messages. Omit it for the inbox.

beforestring date-time

With application_id: the nextBefore of the previous page, for earlier messages.

limitinteger

With application_id: messages to return, 1 to 100. Default 50.

Response

The inbox, or one conversation.

OR

Changes

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