Skip to content
Letta Platform Letta Platform Letta Docs
Sign up

Update Conversation

client.conversations.update(stringconversationID, ConversationUpdateParams { summary } body, RequestOptionsoptions?): Conversation { id, agent_id, created_at, 6 more }
patch/v1/conversations/{conversation_id}

Update a conversation.

ParametersExpand Collapse
conversationID: string

The conversation identifier. Either the special value 'default' or an ID in the format 'conv-'

minLength1
maxLength41
body: ConversationUpdateParams { summary }
summary?: string | null

A summary of the conversation.

ReturnsExpand Collapse
Conversation { id, agent_id, created_at, 6 more }

Represents a conversation on an agent for concurrent messaging.

id: string

The unique identifier of the conversation.

agent_id: string

The ID of the agent this conversation belongs to.

created_at?: string | null

The timestamp when the object was created.

formatdate-time
created_by_id?: string | null

The id of the user that made this object.

in_context_message_ids?: Array<string>

The IDs of in-context messages for the conversation.

isolated_block_ids?: Array<string>

IDs of blocks that are isolated (specific to this conversation, overriding agent defaults).

last_updated_by_id?: string | null

The id of the user that made this object.

summary?: string | null

A summary of the conversation.

updated_at?: string | null

The timestamp when the object was last updated.

formatdate-time
Update Conversation
import Letta from '@letta-ai/letta-client';

const client = new Letta({
  apiKey: process.env['LETTA_API_KEY'], // This is the default and can be omitted
});

const conversation = await client.conversations.update('default');

console.log(conversation.id);
{
  "id": "id",
  "agent_id": "agent_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "in_context_message_ids": [
    "string"
  ],
  "isolated_block_ids": [
    "string"
  ],
  "last_updated_by_id": "last_updated_by_id",
  "summary": "summary",
  "updated_at": "2019-12-27T18:11:19.117Z"
}
Returns Examples
{
  "id": "id",
  "agent_id": "agent_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "in_context_message_ids": [
    "string"
  ],
  "isolated_block_ids": [
    "string"
  ],
  "last_updated_by_id": "last_updated_by_id",
  "summary": "summary",
  "updated_at": "2019-12-27T18:11:19.117Z"
}