Create Conversation

post/v1/conversations/

Create a new conversation for an agent.

Query ParametersExpand Collapse

agent_id: string

The agent ID to create a conversation for

Body ParametersExpand Collapse

isolated_block_labels: optional array of string

List of block labels that should be isolated (conversation-specific) rather than shared across conversations. New blocks will be created as copies of the agent's blocks with these labels.

summary: optional string

A summary of the conversation.

ReturnsExpand Collapse

Conversation = object { 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: optional string

The timestamp when the object was created.

formatdate-time

created_by_id: optional string

The id of the user that made this object.

in_context_message_ids: optional array of string

The IDs of in-context messages for the conversation.

isolated_block_ids: optional array of string

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

last_updated_by_id: optional string

The id of the user that made this object.

summary: optional string

A summary of the conversation.

updated_at: optional string

The timestamp when the object was last updated.

formatdate-time

Create Conversation

curl https://api.letta.com/v1/conversations/ \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LETTA_API_KEY" \
    -d '{}'

{
  "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"
}