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

ActionWhat it does
Attach memory blockGive an agent a memory block to read and update.
Create agentCreate an agent with a model, a system prompt, memory blocks and tools.
Create blockCreate a memory block that agents can read and update.
Delete agentDelete an agent.
Delete blockDelete a memory block.
Delete toolDelete a tool.
Detach memory blockTake a memory block away from an agent, without deleting it.
Get agentGet an agent's details, such as its model, system prompt, tools and memory.
Get blockGet a memory block's label, value and limits.
Get toolGet a tool's details, such as its description and arguments.
List agent blocksList the memory blocks attached to an agent.
List agentsList your agents, optionally filtered by name.
List blocksList your memory blocks, optionally filtered by label.
List messagesList an agent's conversation history, newest last.
List modelsList the language models agents can use.
List toolsList the tools agents can use, optionally filtered by name.
Search toolsFind tools by what they do.
Send messageSend messages to an agent and get its reply.
Update agentChange an agent's name, model, system prompt, tools or tags.
Update blockChange a memory block's label, value, description or limits.

Attach memory block

Give an agent a memory block to read and update.

Inputs

Agentagent_idtextRequired
Agent id.
Blockblock_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

Namenametext
Name.
Descriptiondescriptiontext
Description.
Modelmodeltext
Model.
Embeddingembeddingtext
Embedding.
Systemsystemtext
System.
Memory blocksmemory_blockslist
Memory blocks.
Tool idstool_idslist
Tool ids.
Tagstagslist
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

LabellabeltextRequired
Label.
ValuevaluetextRequired
Value.
Descriptiondescriptiontext
Description.
Limitlimitnumber
Limit.At least 1.
Read onlyread_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

Agentagent_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

Blockblock_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

Tooltool_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

Agentagent_idtextRequired
Agent id.
Blockblock_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

Agentagent_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

Blockblock_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

Tooltool_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

Agentagent_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

Afteraftertext
After.
Limitlimitnumber
Limit.From 1 to 1000. Default: 100.
Namenametext
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

Afteraftertext
After.
Limitlimitnumber
Limit.From 1 to 1000. Default: 100.
Labellabeltext
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

Agentagent_idtextRequired
Agent id.
Afteraftertext
After.
Limitlimitnumber
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

Afteraftertext
After.
Limitlimitnumber
Limit.From 1 to 1000. Default: 100.
Namenametext
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

QueryquerytextRequired
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

Agentagent_idtextRequired
Agent id.
MessagesmessageslistRequired
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

Agentagent_idtextRequired
Agent id.
Namenametext
Name.
Descriptiondescriptiontext
Description.
Modelmodeltext
Model.
Embeddingembeddingtext
Embedding.
Systemsystemtext
System.
Tool idstool_idslist
Tool ids.
Tagstagslist
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

Blockblock_idtextRequired
Block id.
Labellabeltext
Label.
Valuevaluetext
Value.
Descriptiondescriptiontext
Description.
Limitlimitnumber
Limit.At least 1.
Read onlyread_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": ""
}

On this page