{"version":"2.1.265","anchor":"user-message-schema-gains-an-internal-file-attachments-field","canonical_anchor":"user-message-schema-gains-an-internal-file-attachments-field","heading":"User message schema gains an internal file_attachments field","tier":"internal","area":"SDK","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.265\/e\/user-message-schema-gains-an-internal-file-attachments-field","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.265","markdown":"### User message schema gains an internal file_attachments field\n\nUser messages in the SDK now support an internal file_attachments field\n\n**What**\n\nThe schema for user-role messages used by the Claude Code SDK now accepts an optional `file_attachments` array. Each entry can include `file_uuid`, `file_name`, `is_image`, `sha256`, and `file_size`, matching the shape already used by `SDKUserMessageReplay`.\n\n**Why**\n\nThis appears intended for remote clients that need to attach files to a prompt, giving them a defined structure for describing attached files alongside a message.\n\n- Area: SDK\n- Names: `file_attachments`\n- Tier: Under the hood\n- Useful: 2\/5\n- Signal: 2\/5"}