A letta agent persisted in a permissioned space.
tid
Timestamp-based ID
Properties
compactionSettings
ref
xyz.quasigod.lab.letta.defs#compactionSettings
Optional
Automatic-compaction behavior for this agent's conversations. Null/absent uses the default.
createdAt
string
datetime
Required
An RFC 3339 formatted timestamp.
description
string
Optional
Short agent description.
maxLength: 1024 byteshidden
boolean
Optional
Hidden agents are excluded from listings. Expected to be false.
model
string
Required
Model handle used for this agent's turns.
maxLength: 256 bytesmodelSettings
ref
xyz.quasigod.lab.letta.defs#modelSettings
Optional
Tunables for this agent's model.
name
string
Required
Human-readable agent name.
maxLength: 256 bytespinned
boolean
Optional
Pinned agents surface at the top of the agent selector and are the startup-resume preference. Expected to be false.
primaryConversation
string
at-uri
Required
The agent's primary conversation (letta's 'default' conversation). Exactly one per agent, created with the agent.
system
string
Required
System prompt template. Core memory is injected into it at compile time; the compiled result lives in the compiledPrompt sidecar.
maxLength: 100000 bytestags
array
of
string
Optional
Free-form tags.
updatedAt
string
datetime
Required
An RFC 3339 formatted timestamp.
View raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"name",
"system",
"model",
"primaryConversation",
"createdAt",
"updatedAt"
],
"properties": {
"name": {
"type": "string",
"maxLength": 256,
"description": "Human-readable agent name."
},
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"description": "Free-form tags."
},
"model": {
"type": "string",
"maxLength": 256,
"description": "Model handle used for this agent's turns."
},
"hidden": {
"type": "boolean",
"description": "Hidden agents are excluded from listings. Expected to be false."
},
"pinned": {
"type": "boolean",
"description": "Pinned agents surface at the top of the agent selector and are the startup-resume preference. Expected to be false."
},
"system": {
"type": "string",
"maxLength": 100000,
"description": "System prompt template. Core memory is injected into it at compile time; the compiled result lives in the compiledPrompt sidecar."
},
"createdAt": {
"type": "string",
"format": "datetime"
},
"updatedAt": {
"type": "string",
"format": "datetime"
},
"description": {
"type": "string",
"maxLength": 1024,
"description": "Short agent description."
},
"modelSettings": {
"ref": "xyz.quasigod.lab.letta.defs#modelSettings",
"type": "ref",
"description": "Tunables for this agent's model."
},
"compactionSettings": {
"ref": "xyz.quasigod.lab.letta.defs#compactionSettings",
"type": "ref",
"description": "Automatic-compaction behavior for this agent's conversations. Null/absent uses the default."
},
"primaryConversation": {
"type": "string",
"format": "at-uri",
"description": "The agent's primary conversation (letta's 'default' conversation). Exactly one per agent, created with the agent."
}
}
},
"description": "A letta agent persisted in a permissioned space."
}