A letta conversation persisted in a permissioned space. The record is write-once config: the message thread is the messages referencing this conversation, and the in-context window is derived from their status+seq (see xyz.quasigod.lab.letta.message), so appending a message never rewrites this record.
tid
Timestamp-based ID
Properties
agent
string
at-uri
Required
The agent this conversation belongs to.
createdAt
string
datetime
Required
An RFC 3339 formatted timestamp.
hidden
boolean
Optional
Hidden conversations are excluded from listings. Expected to be false.
model
string
Optional
Optional per-conversation model override.
maxLength: 256 bytesmodelSettings
ref
xyz.quasigod.lab.letta.defs#modelSettings
Optional
Optional per-conversation model settings override.
role
string
Required
primary: the agent's main thread (exactly one per agent, referenced by the agent's primaryConversation). fork: a branched copy of a message prefix.
primary, forktitle
string
Optional
Optional display title.
maxLength: 256 bytesupdatedAt
string
datetime
Required
An RFC 3339 formatted timestamp.
View raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"agent",
"role",
"lastSeq",
"createdAt",
"updatedAt"
],
"properties": {
"role": {
"type": "string",
"description": "primary: the agent's main thread (exactly one per agent, referenced by the agent's primaryConversation). fork: a branched copy of a message prefix.",
"knownValues": [
"primary",
"fork"
]
},
"agent": {
"type": "string",
"format": "at-uri",
"description": "The agent this conversation belongs to."
},
"model": {
"type": "string",
"maxLength": 256,
"description": "Optional per-conversation model override."
},
"title": {
"type": "string",
"maxLength": 256,
"description": "Optional display title."
},
"hidden": {
"type": "boolean",
"description": "Hidden conversations are excluded from listings. Expected to be false."
},
"createdAt": {
"type": "string",
"format": "datetime"
},
"updatedAt": {
"type": "string",
"format": "datetime"
},
"modelSettings": {
"ref": "xyz.quasigod.lab.letta.defs#modelSettings",
"type": "ref",
"description": "Optional per-conversation model settings override."
}
}
},
"description": "A letta conversation persisted in a permissioned space. The record is write-once config: the message thread is the messages referencing this conversation, and the in-context window is derived from their status+seq (see xyz.quasigod.lab.letta.message), so appending a message never rewrites this record."
}