Letta Message Structure

{
  "jsonStructure": "0.1",
  "name": "letta-message",
  "title": "Letta Message",
  "description": "Flat structure summary of the Letta Message entity, derived from the Letta OpenAPI 1.0.0 spec.",
  "source": "https://raw.githubusercontent.com/letta-ai/letta/main/fern/openapi.json",
  "entity": "Message",
  "fields": [
    {
      "name": "created_by_id",
      "type": "object",
      "required": false,
      "description": "The id of the user that made this object.",
      "enum": null,
      "format": null
    },
    {
      "name": "last_updated_by_id",
      "type": "object",
      "required": false,
      "description": "The id of the user that made this object.",
      "enum": null,
      "format": null
    },
    {
      "name": "created_at",
      "type": "string",
      "required": false,
      "description": "The timestamp when the object was created.",
      "enum": null,
      "format": "date-time"
    },
    {
      "name": "updated_at",
      "type": "object",
      "required": false,
      "description": "The timestamp when the object was last updated.",
      "enum": null,
      "format": null
    },
    {
      "name": "id",
      "type": "string",
      "required": false,
      "description": "The human-friendly ID of the Message",
      "enum": null,
      "format": null
    },
    {
      "name": "agent_id",
      "type": "object",
      "required": false,
      "description": "The unique identifier of the agent.",
      "enum": null,
      "format": null
    },
    {
      "name": "model",
      "type": "object",
      "required": false,
      "description": "The model used to make the function call.",
      "enum": null,
      "format": null
    },
    {
      "name": "role",
      "type": "string",
      "required": true,
      "description": "",
      "enum": [
        "assistant",
        "user",
        "tool",
        "function",
        "system",
        "approval",
        "summary"
      ],
      "format": null
    },
    {
      "name": "content",
      "type": "object",
      "required": false,
      "description": "The content of the message.",
      "enum": null,
      "format": null
    },
    {
      "name": "name",
      "type": "object",
      "required": false,
      "description": "For role user/assistant: the (optional) name of the participant. For role tool/function: the name of the function called.",
      "enum": null,
      "format": null
    },
    {
      "name": "tool_calls",
      "type": "object",
      "required": false,
      "description": "The list of tool calls requested. Only applicable for role assistant.",
      "enum": null,
      "format": null
    },
    {
      "name": "tool_call_id",
      "type": "object",
      "required": false,
      "description": "The ID of the tool call. Only applicable for role tool.",
      "enum": null,
      "format": null
    },
    {
      "name": "step_id",
      "type": "object",
      "required": false,
      "description": "The id of the step that this message was created in.",
      "enum": null,
      "format": null
    },
    {
      "name": "run_id",
      "type": "object",
      "required": false,
      "description": "The id of the run that this message was created in.",
      "enum": null,
      "format": null
    },
    {
      "name": "otid",
      "type": "object",
      "required": false,
      "description": "The offline threading id associated with this message",
      "enum": null,
      "format": null
    },
    {
      "name": "tool_returns",
      "type": "object",
      "required": false,
      "description": "Tool execution return information for prior tool calls",
      "enum": null,
      "format": null
    },
    {
      "name": "group_id",
      "type": "object",
      "required": false,
      "description": "The multi-agent group that the message was sent in",
      "enum": null,
      "format": null
    },
    {
      "name": "sender_id",
      "type": "object",
      "required": false,
      "description": "The id of the sender of the message, can be an identity id or agent id",
      "enum": null,
      "format": null
    },
    {
      "name": "batch_item_id",
      "type": "object",
      "required": false,
      "description": "The id of the LLMBatchItem that this message is associated with",
      "enum": null,
      "format": null
    },
    {
      "name": "conversation_id",
      "type": "object",
      "required": false,
      "description": "The conversation this message belongs to",
      "enum": null,
      "format": null
    },
    {
      "name": "is_err",
      "type": "object",
      "required": false,
      "description": "Whether this message is part of an error step. Used only for debugging purposes.",
      "enum": null,
      "format": null
    },
    {
      "name": "approval_request_id",
      "type": "object",
      "required": false,
      "description": "The id of the approval request if this message is associated with a tool call request.",
      "enum": null,
      "format": null
    },
    {
      "name": "approve",
      "type": "object",
      "required": false,
      "description": "Whether tool call is approved.",
      "enum": null,
      "format": null
    },
    {
      "name": "denial_reason",
      "type": "object",
      "required": false,
      "description": "The reason the tool call request was denied.",
      "enum": null,
      "format": null
    },
    {
      "name": "approvals",
      "type": "object",
      "required": false,
      "description": "The list of approvals for this message.",
      "enum": null,
      "format": null
    }
  ],
  "fieldCount": 25,
  "requiredCount": 1
}