Chats

Recent messages in an item's chat

Read the recent messages in an item's chat: what the user said there, what Roma replied, and what any agent posted with post_chat_message. On a shared item (shared on its own or through its list) the chat is its Thread, the one conversation the owner and every member see, so you read what the members said too. Pass since to read only what arrived after a moment you already saw; a read that repeats on a schedule passes the createdAt of the last message it saw every time. Empty when the item has no chat yet.

get/api/v1/items/{id}/messages

Request

  • Base URL
    https://api.roma.app
  • URL
    https://api.roma.app/api/v1/items/{id}/messages
  • Auth
    HTTP bearer

Path parameters

idstring required

The item's id, or a Roma link to it (roma.app/artifacts/<id>).

Query parameters

sincestring

ISO 8601 instant. Only messages created after it are returned, oldest first: the createdAt of the last message you saw.

limitinteger

Max messages (default 20).

Response

The tool's result.

sessionIdstring nullable required
truncatedboolean required

Changes

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