conversations.v1.conversation.conversation_message

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/twilio/main/json-schema/twilio-conversations-v1-conversation-conversation-message-schema.json",
  "title": "conversations.v1.conversation.conversation_message",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twilio-conversations-api-openapi.yml#/components/schemas/conversations.v1.conversation.conversation_message",
  "type": "object",
  "properties": {
    "account_sid": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^AC[0-9a-fA-F]{32}$",
      "description": "The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this message."
    },
    "conversation_sid": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^CH[0-9a-fA-F]{32}$",
      "description": "The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message."
    },
    "sid": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^IM[0-9a-fA-F]{32}$",
      "description": "A 34 character string that uniquely identifies this resource."
    },
    "index": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The index of the message within the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource).  Indices may skip numbers, but will always be in order of when the message was received."
    },
    "author": {
      "type": [
        "string",
        "null"
      ],
      "description": "The channel specific identifier of the message's author. Defaults to `system`.",
      "x-twilio": {
        "pii": {
          "handling": "standard",
          "deleteSla": 30
        }
      }
    },
    "body": {
      "type": [
        "string",
        "null"
      ],
      "description": "The content of the message, can be up to 1,600 characters long.",
      "x-twilio": {
        "pii": {
          "handling": "sensitive",
          "deleteSla": 30
        }
      }
    },
    "media": {
      "type": [
        "array",
        "null"
      ],
      "items": {},
      "description": "An array of objects that describe the Message's media, if the message contains media. Each object contains these fields: `content_type` with the MIME type of the media, `filename` with the name of the media, `sid` with the SID of the Media resource, and `size` with the media object's file size in bytes. If the Message has no media, this value is `null`.",
      "x-twilio": {
        "pii": {
          "handling": "standard",
          "deleteSla": 30
        }
      }
    },
    "attributes": {
      "type": [
        "string",
        "null"
      ],
      "description": "A string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified.  **Note** that if the attributes are not set \"{}\" will be returned.",
      "x-twilio": {
        "pii": {
          "handling": "sensitive",
          "deleteSla": 30
        }
      }
    },
    "participant_sid": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^MB[0-9a-fA-F]{32}$",
      "description": "The unique ID of messages's author participant. Null in case of `system` sent message."
    },
    "date_created": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "The date that this resource was created."
    },
    "date_updated": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "The date that this resource was last updated. `null` if the message has not been edited."
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "description": "An absolute API resource API URL for this message."
    },
    "delivery": {
      "description": "An object that contains the summary of delivery statuses for the message to non-chat participants."
    },
    "links": {
      "type": [
        "object",
        "null"
      ],
      "format": "uri-map",
      "description": "Contains an absolute API resource URL to access the delivery & read receipts of this message."
    },
    "content_sid": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^HX[0-9a-fA-F]{32}$",
      "description": "The unique ID of the multi-channel [Rich Content](https://www.twilio.com/docs/content) template."
    }
  }
}