Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
feat: add pagination to agent messages endpoint (#5088)
cthomascb5e89cfa2ca
diff --git a/fern/openapi.json b/fern/openapi.jsonindex e7b4f0962..046276690 100644--- a/fern/openapi.json+++ b/fern/openapi.json@@ -5604,7 +5604,7 @@}},{- "name": "after",+ "name": "before","in": "query","required": false,"schema": {@@ -5616,13 +5616,13 @@"type": "null"}],- "description": "Message after which to retrieve the returned messages.",- "title": "After"+ "description": "Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order",+ "title": "Before"},- "description": "Message after which to retrieve the returned messages."+ "description": "Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order"},{- "name": "before",+ "name": "after","in": "query","required": false,"schema": {@@ -5634,22 +5634,55 @@"type": "null"}],- "description": "Message before which to retrieve the returned messages.",- "title": "Before"+ "description": "Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order",+ "title": "After"},- "description": "Message before which to retrieve the returned messages."+ "description": "Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order"},{"name": "limit","in": "query","required": false,"schema": {- "type": "integer",- "description": "Maximum number of messages to retrieve.",- "default": 10,+ "anyOf": [+ {+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "description": "Maximum number of messages to return",+ "default": 100,"title": "Limit"},- "description": "Maximum number of messages to retrieve."+ "description": "Maximum number of messages to return"+ },+ {+ "name": "order",+ "in": "query",+ "required": false,+ "schema": {+ "enum": ["asc", "desc"],+ "type": "string",+ "description": "Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first",+ "default": "desc",+ "title": "Order"+ },+ "description": "Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first"+ },+ {+ "name": "order_by",+ "in": "query",+ "required": false,+ "schema": {+ "const": "created_at",+ "type": "string",+ "description": "Field to sort by",+ "default": "created_at",+ "title": "Order By"+ },+ "description": "Field to sort by"},{"name": "group_id",diff --git a/letta/server/rest_api/routers/v1/agents.py b/letta/server/rest_api/routers/v1/agents.pyindex c55cfd2c6..93b7907fc 100644--- a/letta/server/rest_api/routers/v1/agents.py+++ b/letta/server/rest_api/routers/v1/agents.py@@ -1072,9 +1072,17 @@ AgentMessagesResponse = Annotated[async def list_messages(agent_id: str,server: "SyncServer" = Depends(get_letta_server),- after: str | None = Query(None, description="Message after which to retrieve the returned messages."),- before: str | None = Query(None, description="Message before which to retrieve the returned messages."),- limit: int = Query(10, description="Maximum number of messages to retrieve."),+ before: Optional[str] = Query(+ None, description="Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order"+ ),+ after: Optional[str] = Query(+ None, description="Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order"+ ),+ limit: Optional[int] = Query(100, description="Maximum number of messages to return"),+ order: Literal["asc", "desc"] = Query(+ "desc", description="Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first"+ ),+ order_by: Literal["created_at"] = Query("created_at", description="Field to sort by"),group_id: str | None = Query(None, description="Group ID to filter messages by."),use_assistant_message: bool = Query(True, description="Whether to use assistant messages"),assistant_message_tool_name: str = Query(DEFAULT_MESSAGE_TOOL, description="The name of the designated message tool."),@@ -1095,7 +1103,7 @@ async def list_messages(before=before,limit=limit,group_id=group_id,- reverse=True,+ reverse=(order == "desc"),return_message_object=False,use_assistant_message=use_assistant_message,assistant_message_tool_name=assistant_message_tool_name,