contains · Chronicle Schema

Used on: Message and their subclasses
Expected type: MediaObject
Values: A list of values
Required: No

Examples

Receiving a message with a photo

A MessageAction for a message Alex sent you.

{
  "@type": "MessageAction",
  "@key": ["source", "sourceId", "@type"],
  "source": "imessage",
  "sourceId": "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5",
  "timestamp": "2026-05-09T18:22:07.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "icloud",
    "handle": "alex@example.com",
    "name": "Alex Chen",
    "sameAs": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "email",
        "handle": "alex@example.com"
      }
    ]
  },
  "object": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "imessage",
    "sourceId": "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5",
    "body": "Found the trailhead!",
    "recipient": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "handle"],
        "source": "phone",
        "handle": "+15555550123",
        "sameAs": ["@me"]
      }
    ],
    "contains": [
      {
        "@type": "ImageObject",
        "@key": ["source", "sourceId"],
        "source": "imessage",
        "sourceId": "E4A7C2D9-1B6F-4F3A-8C5E-7D2B9A0F6E13",
        "contentPath": "/Users/sam/Library/Messages/Attachments/4f/15/trailhead.jpg",
        "mimeType": "image/jpeg",
        "description": "trailhead.jpg"
      }
    ]
  }
}

{
  "@context": {
    "@vocab": "https://schema.chronicle.app/",
    "doc": "https://schema.chronicle.app/docs/"
  },
  "@type": "MessageAction",
  "doc:key": {
    "@list": ["source", "sourceId", "@type"]
  },
  "source": "imessage",
  "sourceId": "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5",
  "timestamp": {
    "@value": "2026-05-09T18:22:07.000Z",
    "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
  },
  "agent": {
    "@type": "Agent",
    "doc:key": {
      "@list": ["@type", "source", "handle"]
    },
    "source": "icloud",
    "handle": "alex@example.com",
    "name": "Alex Chen",
    "sameAs": [
      {
        "@type": "Agent",
        "doc:key": {
          "@list": ["@type", "source", "handle"]
        },
        "source": "email",
        "handle": "alex@example.com"
      }
    ]
  },
  "object": {
    "@type": "Message",
    "doc:key": {
      "@list": ["@type", "source", "sourceId"]
    },
    "source": "imessage",
    "sourceId": "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5",
    "body": "Found the trailhead!",
    "recipient": [
      {
        "@type": "Person",
        "doc:key": {
          "@list": ["@type", "source", "handle"]
        },
        "source": "phone",
        "handle": "+15555550123",
        "sameAs": ["@me"]
      }
    ],
    "contains": [
      {
        "@type": "ImageObject",
        "doc:key": {
          "@list": ["source", "sourceId"]
        },
        "source": "imessage",
        "sourceId": "E4A7C2D9-1B6F-4F3A-8C5E-7D2B9A0F6E13",
        "contentPath": "/Users/sam/Library/Messages/Attachments/4f/15/trailhead.jpg",
        "mimeType": "image/jpeg",
        "description": "trailhead.jpg"
      }
    ]
  }
}

@prefix : <https://schema.chronicle.app/> .
@prefix doc: <https://schema.chronicle.app/docs/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

[
  a :MessageAction;
  doc:key ("source" "sourceId" "@type");
  :source "imessage";
  :sourceId "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5";
  :timestamp "2026-05-09T18:22:07.000Z"^^xsd:dateTime;
  :agent [
    a :Agent;
    doc:key ("@type" "source" "handle");
    :source "icloud";
    :handle "alex@example.com";
    :name "Alex Chen";
    :sameAs [
      a :Agent;
      doc:key ("@type" "source" "handle");
      :source "email";
      :handle "alex@example.com"
    ]
  ];
  :object [
    a :Message;
    doc:key ("@type" "source" "sourceId");
    :source "imessage";
    :sourceId "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5";
    :body "Found the trailhead!";
    :recipient [
      a :Person;
      doc:key ("@type" "source" "handle");
      :source "phone";
      :handle "+15555550123";
      :sameAs "@me"
    ];
    :contains [
      a :ImageObject;
      doc:key ("source" "sourceId");
      :source "imessage";
      :sourceId "E4A7C2D9-1B6F-4F3A-8C5E-7D2B9A0F6E13";
      :contentPath "/Users/sam/Library/Messages/Attachments/4f/15/trailhead.jpg";
      :mimeType "image/jpeg";
      :description "trailhead.jpg"
    ]
  ]
] .

Sharing a video and a PDF with a group

A message to a group has one recipient per person.

{
  "@type": "MessageAction",
  "@key": ["source", "sourceId", "@type"],
  "source": "imessage",
  "sourceId": "C7A3E1F5-2D8B-4C6A-9E0F-4B7D2A5C8E31",
  "timestamp": "2026-06-21T14:10:02.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle"],
    "source": "phone",
    "handle": "+15555550123",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "imessage",
    "sourceId": "C7A3E1F5-2D8B-4C6A-9E0F-4B7D2A5C8E31",
    "body": "Video from the summit, and the permit for Saturday.",
    "recipient": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "icloud",
        "handle": "alex@example.com",
        "name": "Alex Chen"
      },
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "phone",
        "handle": "+15555550188",
        "name": "Jordan Lee"
      }
    ],
    "contains": [
      {
        "@type": "VideoObject",
        "@key": ["source", "sourceId"],
        "source": "imessage",
        "sourceId": "D1F6B3A8-4E2C-4A9D-B5E7-8C0A2F4D6B19",
        "contentPath": "/Users/sam/Library/Messages/Attachments/7c/12/summit.mov",
        "mimeType": "video/quicktime",
        "description": "summit.mov"
      },
      {
        "@type": "DocumentObject",
        "@key": ["source", "sourceId"],
        "source": "imessage",
        "sourceId": "F8C2A5D7-9B1E-4F6C-A3D0-2E5B8C1F4A76",
        "contentPath": "/Users/sam/Library/Messages/Attachments/7c/13/permit.pdf",
        "mimeType": "application/pdf",
        "description": "permit.pdf"
      }
    ]
  }
}

{
  "@context": {
    "@vocab": "https://schema.chronicle.app/",
    "doc": "https://schema.chronicle.app/docs/"
  },
  "@type": "MessageAction",
  "doc:key": {
    "@list": ["source", "sourceId", "@type"]
  },
  "source": "imessage",
  "sourceId": "C7A3E1F5-2D8B-4C6A-9E0F-4B7D2A5C8E31",
  "timestamp": {
    "@value": "2026-06-21T14:10:02.000Z",
    "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
  },
  "agent": {
    "@type": "Person",
    "doc:key": {
      "@list": ["@type", "source", "handle"]
    },
    "source": "phone",
    "handle": "+15555550123",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Message",
    "doc:key": {
      "@list": ["@type", "source", "sourceId"]
    },
    "source": "imessage",
    "sourceId": "C7A3E1F5-2D8B-4C6A-9E0F-4B7D2A5C8E31",
    "body": "Video from the summit, and the permit for Saturday.",
    "recipient": [
      {
        "@type": "Agent",
        "doc:key": {
          "@list": ["@type", "source", "handle"]
        },
        "source": "icloud",
        "handle": "alex@example.com",
        "name": "Alex Chen"
      },
      {
        "@type": "Agent",
        "doc:key": {
          "@list": ["@type", "source", "handle"]
        },
        "source": "phone",
        "handle": "+15555550188",
        "name": "Jordan Lee"
      }
    ],
    "contains": [
      {
        "@type": "VideoObject",
        "doc:key": {
          "@list": ["source", "sourceId"]
        },
        "source": "imessage",
        "sourceId": "D1F6B3A8-4E2C-4A9D-B5E7-8C0A2F4D6B19",
        "contentPath": "/Users/sam/Library/Messages/Attachments/7c/12/summit.mov",
        "mimeType": "video/quicktime",
        "description": "summit.mov"
      },
      {
        "@type": "DocumentObject",
        "doc:key": {
          "@list": ["source", "sourceId"]
        },
        "source": "imessage",
        "sourceId": "F8C2A5D7-9B1E-4F6C-A3D0-2E5B8C1F4A76",
        "contentPath": "/Users/sam/Library/Messages/Attachments/7c/13/permit.pdf",
        "mimeType": "application/pdf",
        "description": "permit.pdf"
      }
    ]
  }
}

@prefix : <https://schema.chronicle.app/> .
@prefix doc: <https://schema.chronicle.app/docs/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

[
  a :MessageAction;
  doc:key ("source" "sourceId" "@type");
  :source "imessage";
  :sourceId "C7A3E1F5-2D8B-4C6A-9E0F-4B7D2A5C8E31";
  :timestamp "2026-06-21T14:10:02.000Z"^^xsd:dateTime;
  :agent [
    a :Person;
    doc:key ("@type" "source" "handle");
    :source "phone";
    :handle "+15555550123";
    :sameAs "@me"
  ];
  :object [
    a :Message;
    doc:key ("@type" "source" "sourceId");
    :source "imessage";
    :sourceId "C7A3E1F5-2D8B-4C6A-9E0F-4B7D2A5C8E31";
    :body "Video from the summit, and the permit for Saturday.";
    :recipient [
      a :Agent;
      doc:key ("@type" "source" "handle");
      :source "icloud";
      :handle "alex@example.com";
      :name "Alex Chen"
    ], [
      a :Agent;
      doc:key ("@type" "source" "handle");
      :source "phone";
      :handle "+15555550188";
      :name "Jordan Lee"
    ];
    :contains [
      a :VideoObject;
      doc:key ("source" "sourceId");
      :source "imessage";
      :sourceId "D1F6B3A8-4E2C-4A9D-B5E7-8C0A2F4D6B19";
      :contentPath "/Users/sam/Library/Messages/Attachments/7c/12/summit.mov";
      :mimeType "video/quicktime";
      :description "summit.mov"
    ], [
      a :DocumentObject;
      doc:key ("source" "sourceId");
      :source "imessage";
      :sourceId "F8C2A5D7-9B1E-4F6C-A3D0-2E5B8C1F4A76";
      :contentPath "/Users/sam/Library/Messages/Attachments/7c/13/permit.pdf";
      :mimeType "application/pdf";
      :description "permit.pdf"
    ]
  ]
] .

URI https://schema.chronicle.app/contains