API Reference

Changelog

March 15, 2025

Message content field extended to include Multi-modal content parts

The content field on UserMessage and AssistantMessage objects returned by our Messages endpoints has been extended to support multi-modal content parts, in anticipation of allowing you to send and receive messages with text, images, and other media.

Before:

1  {
2    "id": "message-dea2ceab-0863-44ea-86dc-70cf02c05946",
3    "date": "2025-01-28T01:18:18+00:00",
4    "message_type": "user_message",
5    "content": "Hello, how are you?"
6  }

After:

1  {
2    "id": "message-dea2ceab-0863-44ea-86dc-70cf02c05946",
3    "date": "2025-01-28T01:18:18+00:00",
4    "message_type": "user_message",
5    "content": [
6      {
7        "type": "text",
8        "text": "Hello, how are you?"
9      }
10    ]
11  }