letta-client 1.0.0a2__py3-none-any.whl → 1.0.0a4__py3-none-any.whl

letta_client/__init__.py

@@ -15,6 +15,8 @@ from .types import (
     ApprovalCreate,
     ApprovalCreateApprovalsItem,
     ApprovalRequestMessage,
+    ApprovalRequestMessageAllowedToolCalls,
+    ApprovalRequestMessageRequestedToolCalls,
     ApprovalRequestMessageToolCall,
     ApprovalResponseMessage,
     ApprovalResponseMessageApprovalsItem,
@@ -444,6 +446,8 @@ from .templates import (
     TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigModelEndpointType,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigModelWrapper,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigModelWrapperItem,
+    TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigParallelToolCalls,
+    TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigParallelToolCallsItem,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigProviderCategory,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigProviderCategoryItem,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigProviderName,
@@ -783,6 +787,8 @@ from .templates import (
     TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemDefaultRequiresApprovalItem,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemDescription,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemDescriptionItem,
+    TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemEnableParallelExecution,
+    TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemEnableParallelExecutionItem,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemJsonSchema,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemJsonSchemaItem,
     TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemLastUpdatedById,
@@ -925,6 +931,8 @@ __all__ = [
     "ApprovalCreate",
     "ApprovalCreateApprovalsItem",
     "ApprovalRequestMessage",
+    "ApprovalRequestMessageAllowedToolCalls",
+    "ApprovalRequestMessageRequestedToolCalls",
     "ApprovalRequestMessageToolCall",
     "ApprovalResponseMessage",
     "ApprovalResponseMessageApprovalsItem",
@@ -1277,6 +1285,8 @@ __all__ = [
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigModelEndpointType",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigModelWrapper",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigModelWrapperItem",
+    "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigParallelToolCalls",
+    "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigParallelToolCallsItem",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigProviderCategory",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigProviderCategoryItem",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemLlmConfigProviderName",
@@ -1616,6 +1626,8 @@ __all__ = [
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemDefaultRequiresApprovalItem",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemDescription",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemDescriptionItem",
+    "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemEnableParallelExecution",
+    "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemEnableParallelExecutionItem",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemJsonSchema",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemJsonSchemaItem",
     "TemplatesCreateAgentsFromTemplateResponseAgentsItemToolsItemLastUpdatedById",

letta_client/agents/blocks/client.py

@@ -39,6 +39,7 @@ class BlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -58,7 +59,7 @@ class BlocksClient:
         )
         client.agents.blocks.retrieve(
             agent_id="agent_id",
-            block_label="block_label",
+            block_label="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.retrieve(agent_id, block_label, request_options=request_options)
@@ -93,6 +94,7 @@ class BlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         value : typing.Optional[str]
             Value of the block.
@@ -154,7 +156,7 @@ class BlocksClient:
         )
         client.agents.blocks.modify(
             agent_id="agent_id",
-            block_label="block_label",
+            block_label="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.modify(
@@ -195,6 +197,7 @@ class BlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
@@ -228,7 +231,7 @@ class BlocksClient:
             token="YOUR_TOKEN",
         )
         client.agents.blocks.list(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             before="before",
             after="after",
             limit=1,
@@ -255,8 +258,10 @@ class BlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -275,8 +280,8 @@ class BlocksClient:
             token="YOUR_TOKEN",
         )
         client.agents.blocks.attach(
-            agent_id="agent_id",
-            block_id="block_id",
+            agent_id="block-123e4567-e89b-42d3-8456-426614174000",
+            block_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.attach(agent_id, block_id, request_options=request_options)
@@ -291,8 +296,10 @@ class BlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -311,8 +318,8 @@ class BlocksClient:
             token="YOUR_TOKEN",
         )
         client.agents.blocks.detach(
-            agent_id="agent_id",
-            block_id="block_id",
+            agent_id="block-123e4567-e89b-42d3-8456-426614174000",
+            block_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.detach(agent_id, block_id, request_options=request_options)
@@ -345,6 +352,7 @@ class AsyncBlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -369,7 +377,7 @@ class AsyncBlocksClient:
         async def main() -> None:
             await client.agents.blocks.retrieve(
                 agent_id="agent_id",
-                block_label="block_label",
+                block_label="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 
@@ -407,6 +415,7 @@ class AsyncBlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         value : typing.Optional[str]
             Value of the block.
@@ -473,7 +482,7 @@ class AsyncBlocksClient:
         async def main() -> None:
             await client.agents.blocks.modify(
                 agent_id="agent_id",
-                block_label="block_label",
+                block_label="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 
@@ -517,6 +526,7 @@ class AsyncBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
@@ -555,7 +565,7 @@ class AsyncBlocksClient:
 
         async def main() -> None:
             await client.agents.blocks.list(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 before="before",
                 after="after",
                 limit=1,
@@ -585,8 +595,10 @@ class AsyncBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -610,8 +622,8 @@ class AsyncBlocksClient:
 
         async def main() -> None:
             await client.agents.blocks.attach(
-                agent_id="agent_id",
-                block_id="block_id",
+                agent_id="block-123e4567-e89b-42d3-8456-426614174000",
+                block_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 
@@ -629,8 +641,10 @@ class AsyncBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -654,8 +668,8 @@ class AsyncBlocksClient:
 
         async def main() -> None:
             await client.agents.blocks.detach(
-                agent_id="agent_id",
-                block_id="block_id",
+                agent_id="block-123e4567-e89b-42d3-8456-426614174000",
+                block_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 

letta_client/agents/blocks/raw_client.py

@@ -34,6 +34,7 @@ class RawBlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -103,6 +104,7 @@ class RawBlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         value : typing.Optional[str]
             Value of the block.
@@ -222,6 +224,7 @@ class RawBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
@@ -293,8 +296,10 @@ class RawBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -344,8 +349,10 @@ class RawBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -402,6 +409,7 @@ class AsyncRawBlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -471,6 +479,7 @@ class AsyncRawBlocksClient:
         agent_id : str
 
         block_label : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         value : typing.Optional[str]
             Value of the block.
@@ -590,6 +599,7 @@ class AsyncRawBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
@@ -661,8 +671,10 @@ class AsyncRawBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -712,8 +724,10 @@ class AsyncRawBlocksClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the block in the format 'block-<uuid4>'
 
         block_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.

letta_client/agents/client.py

@@ -255,6 +255,7 @@ class AgentsClient:
         max_files_open: typing.Optional[int] = OMIT,
         per_file_view_window_char_limit: typing.Optional[int] = OMIT,
         hidden: typing.Optional[bool] = OMIT,
+        parallel_tool_calls: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -394,6 +395,9 @@ class AgentsClient:
         hidden : typing.Optional[bool]
             If set to True, the agent will be hidden.
 
+        parallel_tool_calls : typing.Optional[bool]
+            If set to True, enables parallel tool calling. Defaults to False.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -457,6 +461,7 @@ class AgentsClient:
             max_files_open=max_files_open,
             per_file_view_window_char_limit=per_file_view_window_char_limit,
             hidden=hidden,
+            parallel_tool_calls=parallel_tool_calls,
             request_options=request_options,
         )
         return _response.data
@@ -506,6 +511,7 @@ class AgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         max_steps : typing.Optional[int]
 
@@ -529,7 +535,7 @@ class AgentsClient:
             token="YOUR_TOKEN",
         )
         client.agents.export_file(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             max_steps=1,
             use_legacy_format=True,
         )
@@ -627,6 +633,7 @@ class AgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         include_relationships : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include in the response. If not provided, all relationships are loaded by default. Using this can optimize performance by reducing unnecessary joins.
@@ -648,7 +655,7 @@ class AgentsClient:
             token="YOUR_TOKEN",
         )
         client.agents.retrieve(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.retrieve(
@@ -665,6 +672,7 @@ class AgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -683,7 +691,7 @@ class AgentsClient:
             token="YOUR_TOKEN",
         )
         client.agents.delete(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.delete(agent_id, request_options=request_options)
@@ -723,6 +731,7 @@ class AgentsClient:
         max_files_open: typing.Optional[int] = OMIT,
         per_file_view_window_char_limit: typing.Optional[int] = OMIT,
         hidden: typing.Optional[bool] = OMIT,
+        parallel_tool_calls: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -731,6 +740,7 @@ class AgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         name : typing.Optional[str]
             The name of the agent.
@@ -822,6 +832,9 @@ class AgentsClient:
         hidden : typing.Optional[bool]
             If set to True, the agent will be hidden.
 
+        parallel_tool_calls : typing.Optional[bool]
+            If set to True, enables parallel tool calling. Defaults to False.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -839,7 +852,7 @@ class AgentsClient:
             token="YOUR_TOKEN",
         )
         client.agents.modify(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.modify(
@@ -874,6 +887,7 @@ class AgentsClient:
             max_files_open=max_files_open,
             per_file_view_window_char_limit=per_file_view_window_char_limit,
             hidden=hidden,
+            parallel_tool_calls=parallel_tool_calls,
             request_options=request_options,
         )
         return _response.data
@@ -1166,6 +1180,7 @@ class AsyncAgentsClient:
         max_files_open: typing.Optional[int] = OMIT,
         per_file_view_window_char_limit: typing.Optional[int] = OMIT,
         hidden: typing.Optional[bool] = OMIT,
+        parallel_tool_calls: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -1305,6 +1320,9 @@ class AsyncAgentsClient:
         hidden : typing.Optional[bool]
             If set to True, the agent will be hidden.
 
+        parallel_tool_calls : typing.Optional[bool]
+            If set to True, enables parallel tool calling. Defaults to False.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1376,6 +1394,7 @@ class AsyncAgentsClient:
             max_files_open=max_files_open,
             per_file_view_window_char_limit=per_file_view_window_char_limit,
             hidden=hidden,
+            parallel_tool_calls=parallel_tool_calls,
             request_options=request_options,
         )
         return _response.data
@@ -1433,6 +1452,7 @@ class AsyncAgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         max_steps : typing.Optional[int]
 
@@ -1461,7 +1481,7 @@ class AsyncAgentsClient:
 
         async def main() -> None:
             await client.agents.export_file(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 max_steps=1,
                 use_legacy_format=True,
             )
@@ -1570,6 +1590,7 @@ class AsyncAgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         include_relationships : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include in the response. If not provided, all relationships are loaded by default. Using this can optimize performance by reducing unnecessary joins.
@@ -1596,7 +1617,7 @@ class AsyncAgentsClient:
 
         async def main() -> None:
             await client.agents.retrieve(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 
@@ -1616,6 +1637,7 @@ class AsyncAgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1639,7 +1661,7 @@ class AsyncAgentsClient:
 
         async def main() -> None:
             await client.agents.delete(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 
@@ -1682,6 +1704,7 @@ class AsyncAgentsClient:
         max_files_open: typing.Optional[int] = OMIT,
         per_file_view_window_char_limit: typing.Optional[int] = OMIT,
         hidden: typing.Optional[bool] = OMIT,
+        parallel_tool_calls: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -1690,6 +1713,7 @@ class AsyncAgentsClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         name : typing.Optional[str]
             The name of the agent.
@@ -1781,6 +1805,9 @@ class AsyncAgentsClient:
         hidden : typing.Optional[bool]
             If set to True, the agent will be hidden.
 
+        parallel_tool_calls : typing.Optional[bool]
+            If set to True, enables parallel tool calling. Defaults to False.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1803,7 +1830,7 @@ class AsyncAgentsClient:
 
         async def main() -> None:
             await client.agents.modify(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 
@@ -1841,6 +1868,7 @@ class AsyncAgentsClient:
             max_files_open=max_files_open,
             per_file_view_window_char_limit=per_file_view_window_char_limit,
             hidden=hidden,
+            parallel_tool_calls=parallel_tool_calls,
             request_options=request_options,
         )
         return _response.data

letta_client/agents/context/client.py

@@ -32,6 +32,7 @@ class ContextClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -50,7 +51,7 @@ class ContextClient:
             token="YOUR_TOKEN",
         )
         client.agents.context.retrieve(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.retrieve(agent_id, request_options=request_options)
@@ -81,6 +82,7 @@ class AsyncContextClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -104,7 +106,7 @@ class AsyncContextClient:
 
         async def main() -> None:
             await client.agents.context.retrieve(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 

letta_client/agents/context/raw_client.py

@@ -27,6 +27,7 @@ class RawContextClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -81,6 +82,7 @@ class AsyncRawContextClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.

letta_client/agents/core_memory/client.py

@@ -31,6 +31,7 @@ class CoreMemoryClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -49,7 +50,7 @@ class CoreMemoryClient:
             token="YOUR_TOKEN",
         )
         client.agents.core_memory.retrieve(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.retrieve(agent_id, request_options=request_options)
@@ -79,6 +80,7 @@ class AsyncCoreMemoryClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -102,7 +104,7 @@ class AsyncCoreMemoryClient:
 
         async def main() -> None:
             await client.agents.core_memory.retrieve(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 

letta_client/agents/core_memory/raw_client.py

@@ -28,6 +28,7 @@ class RawCoreMemoryClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -83,6 +84,7 @@ class AsyncRawCoreMemoryClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.