groups

List Group Messages

Changed on

Retrieve message history for an agent.

get/v1/groups/{group_id}/messages

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/groups/{group_id}/messages
  • Auth
    HTTP bearer

Path parameters

group_idstring required

Query parameters

beforestring nullable

Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order

afterstring nullable

Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order

limitinteger nullable

Maximum number of messages to retrieve

order'asc' | 'desc'

Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first

order_by'created_at'

Field to sort by

use_assistant_messageboolean

Whether to use assistant messages

assistant_message_tool_namestring

The name of the designated message tool.

assistant_message_tool_kwargstring

The name of the message argument.

Response

Successful Response

Changes

  • b82cbf314740Revision changes
    • info

      added the optional property // to the response with the status

    • info

      response property items/oneOf[subschema #5: ToolCallMessage]/tool_call deprecated

  • 1bed3816dfe2Revision changes
    • info

      added the optional property // to the response with the status

    • info

      response property items/oneOf[subschema #6: ToolReturnMessage]/status deprecated

    • info

      response property items/oneOf[subschema #6: ToolReturnMessage]/stderr deprecated

    • info

      response property items/oneOf[subschema #6: ToolReturnMessage]/stdout deprecated

    • info

      response property items/oneOf[subschema #6: ToolReturnMessage]/tool_call_id deprecated

    • info

      response property items/oneOf[subschema #6: ToolReturnMessage]/tool_return deprecated