Letta
App · 20 actions
Create and manage Letta agents with long-term memory: send them messages, read their replies, and manage their memory blocks, tools and models.
Actions
| Action | What it does |
|---|---|
| Attach memory block | Give an agent a memory block to read and update. |
| Create agent | Create an agent with a model, a system prompt, memory blocks and tools. |
| Create block | Create a memory block that agents can read and update. |
| Delete agent | Delete an agent. |
| Delete block | Delete a memory block. |
| Delete tool | Delete a tool. |
| Detach memory block | Take a memory block away from an agent, without deleting it. |
| Get agent | Get an agent's details, such as its model, system prompt, tools and memory. |
| Get block | Get a memory block's label, value and limits. |
| Get tool | Get a tool's details, such as its description and arguments. |
| List agent blocks | List the memory blocks attached to an agent. |
| List agents | List your agents, optionally filtered by name. |
| List blocks | List your memory blocks, optionally filtered by label. |
| List messages | List an agent's conversation history, newest last. |
| List models | List the language models agents can use. |
| List tools | List the tools agents can use, optionally filtered by name. |
| Search tools | Find tools by what they do. |
| Send message | Send messages to an agent and get its reply. |
| Update agent | Change an agent's name, model, system prompt, tools or tags. |
| Update block | Change a memory block's label, value, description or limits. |
Attach memory block
Give an agent a memory block to read and update.
Inputs
- Agent
agent_idtextRequired - Agent id.
- Block
block_idtextRequired - Block id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}Create agent
Create an agent with a model, a system prompt, memory blocks and tools.
Inputs
- Name
nametext - Name.
- Description
descriptiontext - Description.
- Model
modeltext - Model.
- Embedding
embeddingtext - Embedding.
- System
systemtext - System.
- Memory blocks
memory_blockslist - Memory blocks.
- Tool ids
tool_idslist - Tool ids.
- Tags
tagslist - Tags.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}Create block
Create a memory block that agents can read and update.
Inputs
- Label
labeltextRequired - Label.
- Value
valuetextRequired - Value.
- Description
descriptiontext - Description.
- Limit
limitnumber - Limit.At least 1.
- Read only
read_onlytrue/false - Read only.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}Delete agent
Delete an agent.
Inputs
- Agent
agent_idtextRequired - Agent id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {},
"next_cursor": ""
}Delete block
Delete a memory block.
Inputs
- Block
block_idtextRequired - Block id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {},
"next_cursor": ""
}Delete tool
Delete a tool.
Inputs
- Tool
tool_idtextRequired - Tool id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {},
"next_cursor": ""
}Detach memory block
Take a memory block away from an agent, without deleting it.
Inputs
- Agent
agent_idtextRequired - Agent id.
- Block
block_idtextRequired - Block id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}Get agent
Get an agent's details, such as its model, system prompt, tools and memory.
Inputs
- Agent
agent_idtextRequired - Agent id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}Get block
Get a memory block's label, value and limits.
Inputs
- Block
block_idtextRequired - Block id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}Get tool
Get a tool's details, such as its description and arguments.
Inputs
- Tool
tool_idtextRequired - Tool id.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}List agent blocks
List the memory blocks attached to an agent.
Inputs
- Agent
agent_idtextRequired - Agent id.
Outputs
datalist- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": [],
"next_cursor": ""
}List agents
List your agents, optionally filtered by name.
Inputs
- After
aftertext - After.
- Limit
limitnumber - Limit.From 1 to 1000. Default:
100. - Name
nametext - Name.
Outputs
datalist- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": [],
"next_cursor": ""
}List blocks
List your memory blocks, optionally filtered by label.
Inputs
- After
aftertext - After.
- Limit
limitnumber - Limit.From 1 to 1000. Default:
100. - Label
labeltext - Label.
Outputs
datalist- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": [],
"next_cursor": ""
}List messages
List an agent's conversation history, newest last.
Inputs
- Agent
agent_idtextRequired - Agent id.
- After
aftertext - After.
- Limit
limitnumber - Limit.From 1 to 1000. Default:
100.
Outputs
datalist- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": [],
"next_cursor": ""
}List models
List the language models agents can use.
Inputs
None.
Outputs
datalist- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": [],
"next_cursor": ""
}List tools
List the tools agents can use, optionally filtered by name.
Inputs
- After
aftertext - After.
- Limit
limitnumber - Limit.From 1 to 1000. Default:
100. - Name
nametext - Name.
Outputs
datalist- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": [],
"next_cursor": ""
}Search tools
Find tools by what they do.
Inputs
- Query
querytextRequired - Query.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {},
"next_cursor": ""
}Send message
Send messages to an agent and get its reply.
Inputs
- Agent
agent_idtextRequired - Agent id.
- Messages
messageslistRequired - Messages.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {},
"next_cursor": ""
}Update agent
Change an agent's name, model, system prompt, tools or tags.
Inputs
- Agent
agent_idtextRequired - Agent id.
- Name
nametext - Name.
- Description
descriptiontext - Description.
- Model
modeltext - Model.
- Embedding
embeddingtext - Embedding.
- System
systemtext - System.
- Tool ids
tool_idslist - Tool ids.
- Tags
tagslist - Tags.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}Update block
Change a memory block's label, value, description or limits.
Inputs
- Block
block_idtextRequired - Block id.
- Label
labeltext - Label.
- Value
valuetext - Value.
- Description
descriptiontext - Description.
- Limit
limitnumber - Limit.At least 1.
- Read only
read_onlytrue/false - Read only.
Outputs
dataobject- Response.
next_cursortext- Continuation token, when returned by the service.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"label": "example",
"name": "example",
"updated_at": "example",
"value": "example"
},
"next_cursor": ""
}