steps

List Messages For Step

Changed on

List messages for a given step.

get/v1/steps/{step_id}/messages

Request

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

Path parameters

step_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'

Sort by field

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