Letta · JSON Structure

Letta Structure

Structural overview of the Letta API surface; extracted from openapi/.

Type: Properties: 0
AIAgentsStateful AgentsMemoryMemGPTContinual LearningMCPMulti-AgentRAGOpen Source

Letta Structure is a JSON Structure definition published by Letta.

Meta-schema:

JSON Structure

Raw ↑
{
  "provider": "Letta",
  "providerId": "letta",
  "kind": "json-structure",
  "description": "Structural overview of the Letta API surface; extracted from openapi/.",
  "schemaCount": 347,
  "operationCount": 302,
  "schemas": [
    {
      "name": "AgentEnvironmentVariable",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "key",
        "value",
        "agent_id"
      ]
    },
    {
      "name": "AgentFileAttachment",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "id",
        "file_id",
        "file_name",
        "folder_id",
        "folder_name",
        "is_open"
      ]
    },
    {
      "name": "AgentFileSchema",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "agents",
        "groups",
        "blocks",
        "files",
        "sources",
        "tools",
        "mcp_servers"
      ]
    },
    {
      "name": "AgentState",
      "type": "object",
      "propertyCount": 45,
      "required": [
        "id",
        "name",
        "system",
        "agent_type",
        "llm_config",
        "memory",
        "blocks",
        "tools",
        "sources",
        "tags"
      ]
    },
    {
      "name": "AgentType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "Annotation",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "type",
        "url_citation"
      ]
    },
    {
      "name": "AnnotationURLCitation",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "end_index",
        "start_index",
        "title",
        "url"
      ]
    },
    {
      "name": "AnthropicModelSettings",
      "type": "object",
      "propertyCount": 9,
      "required": []
    },
    {
      "name": "AnthropicThinking",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "ApprovalCreate",
      "type": "object",
      "propertyCount": 7,
      "required": []
    },
    {
      "name": "ApprovalRequestMessage",
      "type": "object",
      "propertyCount": 12,
      "required": [
        "id",
        "date",
        "tool_call"
      ]
    },
    {
      "name": "ApprovalResponseMessage",
      "type": "object",
      "propertyCount": 14,
      "required": [
        "id",
        "date"
      ]
    },
    {
      "name": "ApprovalReturn",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "tool_call_id",
        "approve"
      ]
    },
    {
      "name": "ArchivalMemorySearchResponse",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "results",
        "count"
      ]
    },
    {
      "name": "ArchivalMemorySearchResult",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "id",
        "timestamp",
        "content"
      ]
    },
    {
      "name": "Archive",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "created_at",
        "name",
        "organization_id"
      ]
    },
    {
      "name": "ArchiveCreateRequest",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "name"
      ]
    },
    {
      "name": "ArchiveUpdateRequest",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "AssistantMessage",
      "type": "object",
      "propertyCount": 11,
      "required": [
        "id",
        "date",
        "content"
      ]
    },
    {
      "name": "AssistantMessageListResult",
      "type": "object",
      "propertyCount": 6,
      "required": [
        "content",
        "message_id",
        "created_at"
      ]
    },
    {
      "name": "Audio",
      "type": "object",
      "propertyCount": 1,
      "required": [
        "id"
      ]
    },
    {
      "name": "AuthRequest",
      "type": "object",
      "propertyCount": 1,
      "required": []
    },
    {
      "name": "AuthResponse",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "uuid"
      ]
    },
    {
      "name": "AzureModelSettings",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "Base64Image",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "media_type",
        "data"
      ]
    },
    {
      "name": "BaseToolRuleSchema",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "tool_name",
        "type"
      ]
    },
    {
      "name": "BasetenModelSettings",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "BatchJob",
      "type": "object",
      "propertyCount": 18,
      "required": []
    },
    {
      "name": "BedrockModelSettings",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "BillingContext",
      "type": "object",
      "propertyCount": 3,
      "required": []
    },
    {
      "name": "Block",
      "type": "object",
      "propertyCount": 19,
      "required": [
        "value"
      ]
    },
    {
      "name": "BlockResponse",
      "type": "object",
      "propertyCount": 19,
      "required": [
        "value",
        "id"
      ]
    },
    {
      "name": "BlockSchema",
      "type": "object",
      "propertyCount": 17,
      "required": [
        "value",
        "label",
        "id"
      ]
    },
    {
      "name": "BlockUpdate",
      "type": "object",
      "propertyCount": 16,
      "required": []
    },
    {
      "name": "Body_export_agent",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "Body_import_agent",
      "type": "object",
      "propertyCount": 13,
      "required": [
        "file"
      ]
    },
    {
      "name": "Body_upload_file_to_folder",
      "type": "object",
      "propertyCount": 1,
      "required": [
        "file"
      ]
    },
    {
      "name": "Body_upload_file_to_source",
      "type": "object",
      "propertyCount": 1,
      "required": [
        "file"
      ]
    },
    {
      "name": "CancelAgentRunRequest",
      "type": "object",
      "propertyCount": 1,
      "required": []
    },
    {
      "name": "ChatCompletion",
      "type": "object",
      "propertyCount": 8,
      "required": [
        "id",
        "choices",
        "created",
        "model",
        "object"
      ]
    },
    {
      "name": "ChatCompletionAssistantMessageParam",
      "type": "object",
      "propertyCount": 7,
      "required": [
        "role"
      ]
    },
    {
      "name": "ChatCompletionAudio",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "id",
        "data",
        "expires_at",
        "transcript"
      ]
    },
    {
      "name": "ChatCompletionContentPartImageParam",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "image_url",
        "type"
      ]
    },
    {
      "name": "ChatCompletionContentPartInputAudioParam",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "input_audio",
        "type"
      ]
    },
    {
      "name": "ChatCompletionContentPartRefusalParam",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "refusal",
        "type"
      ]
    },
    {
      "name": "ChatCompletionContentPartTextParam",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "text",
        "type"
      ]
    },
    {
      "name": "ChatCompletionDeveloperMessageParam",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "content",
        "role"
      ]
    },
    {
      "name": "ChatCompletionFunctionMessageParam",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "content",
        "name",
        "role"
      ]
    },
    {
      "name": "ChatCompletionMessage",
      "type": "object",
      "propertyCount": 7,
      "required": [
        "role"
      ]
    },
    {
      "name": "ChatCompletionMessageCustomToolCall",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "id",
        "custom",
        "type"
      ]
    },
    {
      "name": "ChatCompletionMessageCustomToolCallParam",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "id",
        "custom",
        "type"
      ]
    },
    {
      "name": "ChatCompletionMessageFunctionToolCall-Input",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "id",
        "function",
        "type"
      ]
    },
    {
      "name": "ChatCompletionMessageFunctionToolCall-Output",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "id",
        "function",
        "type"
      ]
    },
    {
      "name": "ChatCompletionMessageFunctionToolCallParam",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "id",
        "function",
        "type"
      ]
    },
    {
      "name": "ChatCompletionRequest",
      "type": "object",
      "propertyCount": 11,
      "required": [
        "model",
        "messages"
      ]
    },
    {
      "name": "ChatCompletionSystemMessageParam",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "content",
        "role"
      ]
    },
    {
      "name": "ChatCompletionToolMessageParam",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "content",
        "role",
        "tool_call_id"
      ]
    },
    {
      "name": "ChatCompletionUserMessageParam",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "content",
        "role"
      ]
    },
    {
      "name": "ChatGPTOAuthModelSettings",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "ChatGPTOAuthReasoning",
      "type": "object",
      "propertyCount": 1,
      "required": []
    },
    {
      "name": "ChildToolRule",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "tool_name",
        "children"
      ]
    },
    {
      "name": "ChildToolRuleSchema",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "tool_name",
        "type",
        "children"
      ]
    },
    {
      "name": "Choice",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "finish_reason",
        "index",
        "message"
      ]
    },
    {
      "name": "ClientSkillSchema",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "name",
        "description",
        "location"
      ]
    },
    {
      "name": "ClientToolSchema",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "name"
      ]
    },
    {
      "name": "CodeInput",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "code"
      ]
    },
    {
      "name": "CompactionResponse",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "summary",
        "num_messages_before",
        "num_messages_after"
      ]
    },
    {
      "name": "CompactionSettings-Input",
      "type": "object",
      "propertyCount": 7,
      "required": []
    },
    {
      "name": "CompactionSettings-Output",
      "type": "object",
      "propertyCount": 7,
      "required": []
    },
    {
      "name": "CompactionStats",
      "type": "object",
      "propertyCount": 6,
      "required": [
        "trigger",
        "context_window",
        "messages_count_before",
        "messages_count_after"
      ]
    },
    {
      "name": "ComparisonOperator",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "CompletionTokensDetails",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "CompletionUsage",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "completion_tokens",
        "prompt_tokens",
        "total_tokens"
      ]
    },
    {
      "name": "ConditionalToolRule",
      "type": "object",
      "propertyCount": 6,
      "required": [
        "tool_name",
        "child_output_mapping"
      ]
    },
    {
      "name": "ConditionalToolRuleSchema",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "tool_name",
        "type",
        "default_child",
        "child_output_mapping",
        "require_output_mapping"
      ]
    },
    {
      "name": "ContextWindowOverview",
      "type": "object",
      "propertyCount": 23,
      "required": [
        "context_window_size_max",
        "context_window_size_current",
        "num_messages",
        "num_archival_memory",
        "num_recall_memory",
        "num_tokens_external_memory_summary",
        "external_memory_summary",
        "num_tokens_system",
        "system_prompt",
        "num_tokens_core_memory",
        "core_memory",
        "num_tokens_summary_memory",
        "num_tokens_functions_definitions",
        "functions_definitions",
        "num_tokens_messages",
        "messages"
      ]
    },
    {
      "name": "ContinueToolRule",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "tool_name"
      ]
    },
    {
      "name": "Conversation",
      "type": "object",
      "propertyCount": 12,
      "required": [
        "id",
        "agent_id"
      ]
    },
    {
      "name": "ConversationMessageRequest",
      "type": "object",
      "propertyCount": 21,
      "required": []
    },
    {
      "name": "CoreMemoryBlockSchema",
      "type": "object",
      "propertyCount": 9,
      "required": [
        "created_at",
        "description",
        "is_template",
        "label",
        "limit",
        "template_name",
        "updated_at",
        "value"
      ]
    },
    {
      "name": "CreateAgentRequest",
      "type": "object",
      "propertyCount": 48,
      "required": []
    },
    {
      "name": "CreateArchivalMemory",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "text"
      ]
    },
    {
      "name": "CreateBatch",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "requests"
      ]
    },
    {
      "name": "CreateBlock",
      "type": "object",
      "propertyCount": 16,
      "required": [
        "value",
        "label"
      ]
    },
    {
      "name": "CreateConversation",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "CreateMCPServerRequest",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "server_name",
        "config"
      ]
    },
    {
      "name": "CreateSSEMCPServer",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "server_url"
      ]
    },
    {
      "name": "CreateStdioMCPServer",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "command",
        "args"
      ]
    },
    {
      "name": "CreateStreamableHTTPMCPServer",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "server_url"
      ]
    },
    {
      "name": "Custom-Input",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "input",
        "name"
      ]
    },
    {
      "name": "Custom-Output",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "input",
        "name"
      ]
    },
    {
      "name": "DeepseekModelSettings",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "DeleteDeploymentResponse",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "message"
      ]
    },
    {
      "name": "DeploymentEntity",
      "type": "object",
      "propertyCount": 6,
      "required": [
        "id",
        "type"
      ]
    },
    {
      "name": "DuplicateFileHandling",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "DynamicManager",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "manager_agent_id"
      ]
    },
    {
      "name": "DynamicManagerSchema",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "manager_agent_id"
      ]
    },
    {
      "name": "DynamicManagerUpdate",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "E2BSandboxConfig",
      "type": "object",
      "propertyCount": 3,
      "required": []
    },
    {
      "name": "EmbeddingConfig",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "embedding_endpoint_type",
        "embedding_model",
        "embedding_dim"
      ]
    },
    {
      "name": "EmbeddingModel",
      "type": "object",
      "propertyCount": 15,
      "required": [
        "name",
        "display_name",
        "provider_type",
        "provider_name",
        "embedding_endpoint_type",
        "embedding_model",
        "embedding_dim"
      ]
    },
    {
      "name": "EventMessage",
      "type": "object",
      "propertyCount": 12,
      "required": [
        "id",
        "date",
        "event_type",
        "event_data"
      ]
    },
    {
      "name": "ExportAgentRequest",
      "type": "object",
      "propertyCount": 3,
      "required": []
    },
    {
      "name": "FeedbackType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "File",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "file",
        "type"
      ]
    },
    {
      "name": "FileAgentSchema",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "agent_id",
        "file_id",
        "source_id",
        "file_name",
        "id"
      ]
    },
    {
      "name": "FileBlock",
      "type": "object",
      "propertyCount": 23,
      "required": [
        "value",
        "file_id",
        "source_id",
        "is_open"
      ]
    },
    {
      "name": "FileFile",
      "type": "object",
      "propertyCount": 3,
      "required": []
    },
    {
      "name": "FileMetadata",
      "type": "object",
      "propertyCount": 16,
      "required": [
        "source_id"
      ]
    },
    {
      "name": "FileProcessingStatus",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "FileSchema",
      "type": "object",
      "propertyCount": 14,
      "required": [
        "source_id",
        "id"
      ]
    },
    {
      "name": "FileStats",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "file_id",
        "file_name"
      ]
    },
    {
      "name": "Folder",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "name",
        "embedding_config"
      ]
    },
    {
      "name": "Function-Output",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "arguments",
        "name"
      ]
    },
    {
      "name": "FunctionCall-Input",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "arguments",
        "name"
      ]
    },
    {
      "name": "FunctionCall-Output",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "arguments",
        "name"
      ]
    },
    {
      "name": "FunctionDefinition",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "name"
      ]
    },
    {
      "name": "FunctionTool",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "function",
        "type"
      ]
    },
    {
      "name": "GeminiThinkingConfig",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "GenerateRequest",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "prompt"
      ]
    },
    {
      "name": "GenerateResponse",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "content",
        "model",
        "usage"
      ]
    },
    {
      "name": "GenerateToolInput",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "tool_name",
        "prompt",
        "validation_errors"
      ]
    },
    {
      "name": "GenerateToolOutput",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "tool",
        "sample_args",
        "response"
      ]
    },
    {
      "name": "GoogleAIModelSettings",
      "type": "object",
      "propertyCount": 6,
      "required": []
    },
    {
      "name": "GoogleVertexModelSettings",
      "type": "object",
      "propertyCount": 6,
      "required": []
    },
    {
      "name": "GroqModelSettings",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "Group",
      "type": "object",
      "propertyCount": 18,
      "required": [
        "id",
        "manager_type",
        "agent_ids",
        "description"
      ]
    },
    {
      "name": "GroupCreate",
      "type": "object",
      "propertyCount": 6,
      "required": [
        "agent_ids",
        "description"
      ]
    },
    {
      "name": "GroupSchema",
      "type": "object",
      "propertyCount": 7,
      "required": [
        "agent_ids",
        "description",
        "id"
      ]
    },
    {
      "name": "GroupUpdate",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "HTTPValidationError",
      "type": "object",
      "propertyCount": 1,
      "required": []
    },
    {
      "name": "Health",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "version",
        "status"
      ]
    },
    {
      "name": "HiddenReasoningMessage",
      "type": "object",
      "propertyCount": 12,
      "required": [
        "id",
        "date",
        "state"
      ]
    },
    {
      "name": "Identity",
      "type": "object",
      "propertyCount": 8,
      "required": [
        "identifier_key",
        "name",
        "identity_type",
        "agent_ids",
        "block_ids"
      ]
    },
    {
      "name": "IdentityCreate",
      "type": "object",
      "propertyCount": 7,
      "required": [
        "identifier_key",
        "name",
        "identity_type"
      ]
    },
    {
      "name": "IdentityProperty",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "key",
        "value",
        "type"
      ]
    },
    {
      "name": "IdentityPropertyType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "IdentityType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "IdentityUpdate",
      "type": "object",
      "propertyCount": 6,
      "required": []
    },
    {
      "name": "IdentityUpsert",
      "type": "object",
      "propertyCount": 7,
      "required": [
        "identifier_key",
        "name",
        "identity_type"
      ]
    },
    {
      "name": "ImageContent",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "source"
      ]
    },
    {
      "name": "ImageURL",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "url"
      ]
    },
    {
      "name": "ImportedAgentsResponse",
      "type": "object",
      "propertyCount": 1,
      "required": [
        "agent_ids"
      ]
    },
    {
      "name": "InitToolRule",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "tool_name"
      ]
    },
    {
      "name": "InputAudio",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "data",
        "format"
      ]
    },
    {
      "name": "InternalTemplateAgentCreate",
      "type": "object",
      "propertyCount": 50,
      "required": [
        "template_id",
        "base_template_id",
        "deployment_id",
        "entity_id"
      ]
    },
    {
      "name": "InternalTemplateBlockCreate",
      "type": "object",
      "propertyCount": 16,
      "required": [
        "value",
        "template_id",
        "base_template_id",
        "deployment_id",
        "entity_id",
        "label"
      ]
    },
    {
      "name": "InternalTemplateGroupCreate",
      "type": "object",
      "propertyCount": 9,
      "required": [
        "agent_ids",
        "description",
        "base_template_id",
        "template_id",
        "deployment_id"
      ]
    },
    {
      "name": "Job",
      "type": "object",
      "propertyCount": 18,
      "required": []
    },
    {
      "name": "JobStatus",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "JobType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "JsonObjectResponseFormat",
      "type": "object",
      "propertyCount": 1,
      "required": []
    },
    {
      "name": "JsonSchemaResponseFormat",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "json_schema"
      ]
    },
    {
      "name": "LLMConfig",
      "type": "object",
      "propertyCount": 27,
      "required": [
        "model",
        "model_endpoint_type",
        "context_window"
      ]
    },
    {
      "name": "LettaAsyncRequest",
      "type": "object",
      "propertyCount": 17,
      "required": []
    },
    {
      "name": "LettaBatchMessages",
      "type": "object",
      "propertyCount": 1,
      "required": [
        "messages"
      ]
    },
    {
      "name": "LettaBatchRequest",
      "type": "object",
      "propertyCount": 17,
      "required": [
        "agent_id"
      ]
    },
    {
      "name": "LettaErrorMessage",
      "type": "object",
      "propertyCount": 6,
      "required": [
        "message_type",
        "run_id",
        "error_type",
        "message"
      ]
    },
    {
      "name": "LettaImage",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "file_id"
      ]
    },
    {
      "name": "LettaPing",
      "type": "object",
      "propertyCount": 10,
      "required": [
        "id",
        "date"
      ]
    },
    {
      "name": "LettaRequest",
      "type": "object",
      "propertyCount": 16,
      "required": []
    },
    {
      "name": "LettaRequestConfig",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "LettaResponse",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "messages",
        "stop_reason",
        "usage"
      ]
    },
    {
      "name": "LettaStopReason",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "stop_reason"
      ]
    },
    {
      "name": "LettaStreamingRequest",
      "type": "object",
      "propertyCount": 20,
      "required": []
    },
    {
      "name": "LettaStreamingResponse",
      "type": null,
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "LettaUsageStatistics",
      "type": "object",
      "propertyCount": 10,
      "required": []
    },
    {
      "name": "ListDeploymentEntitiesResponse",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "total_count",
        "deployment_id",
        "message"
      ]
    },
    {
      "name": "LocalSandboxConfig",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "MCPServerSchema",
      "type": "object",
      "propertyCount": 6,
      "required": [
        "id",
        "server_type",
        "server_name"
      ]
    },
    {
      "name": "MCPServerType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "MCPTool",
      "type": "object",
      "propertyCount": 8,
      "required": [
        "name",
        "inputSchema"
      ]
    },
    {
      "name": "MCPToolHealth",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "status"
      ]
    },
    {
      "name": "ManagerType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "MaxCountPerStepToolRule",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "tool_name",
        "max_count_limit"
      ]
    },
    {
      "name": "MaxCountPerStepToolRuleSchema",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "tool_name",
        "type",
        "max_count_limit"
      ]
    },
    {
      "name": "Memory",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "blocks"
      ]
    },
    {
      "name": "Message",
      "type": "object",
      "propertyCount": 25,
      "required": [
        "role"
      ]
    },
    {
      "name": "MessageCreate",
      "type": "object",
      "propertyCount": 8,
      "required": [
        "role",
        "content"
      ]
    },
    {
      "name": "MessageRole",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "MessageSearchCacheWarmScope",
      "type": "object",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "MessageSearchRequest",
      "type": "object",
      "propertyCount": 10,
      "required": []
    },
    {
      "name": "MessageSearchResult",
      "type": "object",
      "propertyCount": 5,
      "required": [
        "embedded_text",
        "message",
        "rrf_score"
      ]
    },
    {
      "name": "MessageType",
      "type": "string",
      "propertyCount": 0,
      "required": []
    },
    {
      "name": "ModalSandboxConfig",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "Model",
      "type": "object",
      "propertyCount": 31,
      "required": [
        "name",
        "provider_type",
        "model",
        "model_endpoint_type",
        "context_window",
        "max_context_window"
      ]
    },
    {
      "name": "ModifyApprovalRequest",
      "type": "object",
      "propertyCount": 1,
      "required": [
        "requires_approval"
      ]
    },
    {
      "name": "ModifyFeedbackRequest",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "NpmRequirement",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "name"
      ]
    },
    {
      "name": "OmittedReasoningContent",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "OpenAIModelSettings",
      "type": "object",
      "propertyCount": 7,
      "required": []
    },
    {
      "name": "OpenAIReasoning",
      "type": "object",
      "propertyCount": 1,
      "required": []
    },
    {
      "name": "OpenRouterModelSettings",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "Organization",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "OrganizationCreate",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "OrganizationSourcesStats",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "OrganizationUpdate",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "PaginatedAgentFiles",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "files",
        "has_more"
      ]
    },
    {
      "name": "ParameterProperties",
      "type": "object",
      "propertyCount": 2,
      "required": [
        "type"
      ]
    },
    {
      "name": "ParametersSchema",
      "type": "object",
      "propertyCount": 3,
      "required": [
        "properties"
      ]
    },
    {
      "name": "ParentToolRule",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "tool_name",
        "children"
      ]
    },
    {
      "name": "Passage",
      "type": "object",
      "propertyCount": 15,
      "required": [
        "text",
        "embedding",
        "embedding_config"
      ]
    },
    {
      "name": "PassageBatchCreateRequest",
      "type": "object",
      "propertyCount": 1,
      "required": [
        "passages"
      ]
    },
    {
      "name": "PassageCreateRequest",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "text"
      ]
    },
    {
      "name": "PassageSearchRequest",
      "type": "object",
      "propertyCount": 

# --- truncated at 32 KB (117 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/letta/refs/heads/main/json-structure/letta-structure.json