runs

List Run Messages

Changed on

Get response messages associated with a run.

get/v1/runs/{run_id}/messages

Request

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

Path parameters

run_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 return

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

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