Documentation

Community

Guides

News

Letta

API reference

Python SDK

Retrieve the memory blocks of a specific agent.

Get Agent Memory Blocks

A Block represents a reserved section of the LLM's context window which is editable. `Block` objects contained in the `Memory` object, which is able to edit the Block values.

Parameters:
    label (str): The label of the block (e.g. 'human', 'persona'). This defines a category for the block.
    value (str): The value of the block. This is the string that is represented in the context window.
    limit (int): The character limit of the block.
    is_template (bool): Whether the block is a template (e.g. saved human/persona options). Non-template blocks are not stored in the database and are ephemeral, while templated blocks are stored in the database.
    label (str): The label of the block (e.g. 'human', 'persona'). This defines a category for the block.
    template_name (str): The name of the block template (if it is a template).
    description (str): Description of the block.
    metadata_ (Dict): Metadata of the block.
    user_id (str): The unique identifier of the user associated with the block.

Created By Id

Description

Whether the block is a template (e.g. saved human/persona options).

Is Template

Label of the block (e.g. 'human', 'persona') in the context window.

Label

The id of the user that last updated this Block.

Last Updated By Id

Limit

Metadata 

Name

The unique identifier of the organization associated with the block.

Organization Id

Value

Block

Location

Message

Error Type

ValidationError

Response Get Agent Memory Blocks

HTTPValidationError

Letta is an AI platform for building stateful LLM applications.

Overview

Welcome to Letta

Quickstart

Developer quickstart

Install and setup Letta to run the server & ADE

Run with pip

Run Letta server with pip

Run with Docker

Run Letta server with Docker

OpenAI

OpenAI proxy

OpenAI-compatible endpoint

Anthropic

Groq

Together

Google AI (Gemini)

Ollama

vLLM

Azure OpenAI

Letta concepts

Key concepts

MemGPT concepts

MemGPT

A guide on common pitfalls and how to resolve them in the ADE

Troubleshooting

Tools

Memory

Messaging agents

Message streaming

Streaming support

Understanding the concept of LLM memory management introduced in MemGPT

Memory management

Understanding memory management

Learn how to create custom memory classes

Custom memory

Creating custom memory classes

Get Tool

Delete Tool

Update Tool

Get Tool Id

Get a list of all tools available to agents belonging to the org of the user

List Tools

Upsert Tool

Create Tool

Add Base Tools

Attempt to build a tool from source, then run it on the provided arguments

Run Tool From Source

List Composio Apps

Get a list of all Composio actions for a specific app

List Composio Actions By App

Add a new Composio tool by action name (Composio refers to each tool as an `Action`)

Add Composio Tool

Get Source

Delete Source

Update the name or documentation of an existing data source.

Update Source

Get Source Id By Name

List Sources

Create Source

Attach a data source to an existing agent.

Attach Source To Agent

Detach a data source from an existing agent.

Detach Source From Agent

Upload File To Source

List all passages associated with a data source.

List Passages

List paginated files associated with a data source.

List Files From Source

Delete File From Source

List all agents associated with a given user.
This endpoint retrieves a list of all agents and their configurations associated with the specified user ID.

List Agents

Create a new agent with the specified configuration.

Create Agent

Retrieve the context window of a specific agent.

Get Agent Context Window

Get Agent State

Delete Agent

Update Agent

Get Tools From Agent

Add Tool To Agent

Remove Tool From Agent

Get the sources associated with an agent.

Get Agent Sources

Retrieve the messages in the context of a specific agent.

Get Agent In Context Messages

Retrieve the memory state of a specific agent.
This endpoint fetches the current memory state of the agent identified by the user ID and agent ID.

Get Agent Memory

Get Agent Memory Block

Removes a memory block from an agent by unlnking it. If the block is not linked to any other agent, it is deleted.

Remove Agent Memory Block

Update Agent Memory Block

Creates a memory block and links it to the agent.

Add Agent Memory Block

Retrieve the summary of the recall memory of a specific agent.

Get Agent Recall Memory Summary

Retrieve the summary of the archival memory of a specific agent.

Get Agent Archival Memory Summary

Retrieve the memories in an agent's archival memory store (paginated query).

Get Agent Archival Memory

Insert a memory into an agent's archival memory store.

Insert Agent Archival Memory

Delete a memory from an agent's archival memory store.

Delete Agent Archival Memory

Get Agent Messages

Process a user message and return the agent's response.
This endpoint accepts a message from a user and processes it through the agent.

Send Message

Update the details of a message associated with an agent.

Update Message

Process a user message and return the agent's response.
This endpoint accepts a message from a user and processes it through the agent.
It will stream the steps of the response always, and stream the tokens if 'stream_tokens' is set to True.

Send Message Streaming

Asynchronously process a user message and return a job ID.
The actual processing happens in the background, and the status can be checked using the job ID.

Send Message Async

List Llm Backends

List Embedding Backends

List Blocks

Create Block

Get Block

Delete Block

Update Block

Link Agent Memory Block

Unlink Agent Memory Block

List Jobs

List Active Jobs

Get Job

Delete Job

Health Check

List Sandbox Configs

Create Sandbox Config

Create Default E2B Sandbox Config

Create Default Local Sandbox Config

Delete Sandbox Config

Update Sandbox Config

List Sandbox Env Vars

Create Sandbox Env Var

Delete Sandbox Env Var

Update Sandbox Env Var

List Users

Update User

Create User

Delete User

Get Api Keys

Create New Api Key

Delete Api Key

Get All Orgs

Create Org

Delete Org

Authenticates the user and sends response with User related data.

Currently, this is a placeholder that simply returns a UUID placeholder

tools

sources

agents

models

blocks

jobs

health

sandbox-config

users

organization

auth

Get Agent Memory Blocks

Headers

Path Parameters

Response