ChronicleSchema

Properties

PropertyExpected typeDescription
From Action
agent one Agent Who performed the action. An action whose performer is unknown has no agent.
endTime one DateTime When the action ended. A date gives the end at that date's precision and includes the whole period, so 1990 runs to the end of 1990.
instrument many Entity The tool, device, application, or model used to perform an action. The agent is who acted. The instrument is what they used. When only the kind of device is known, it is a ProductModel rather than a Device.
location one Location or Place Where the action happened, or where the entity or event is.
object one Entity The entity an action was carried out on, such as the article read, the photo shared, or the place visited. For a movement, such as a TravelAction, the object is where it began.
result one Entity What the action produced, such as a work or a session. Seen from what it produced, the action is its resultOf value.
startTime one DateTime When the action started. A date gives the start at that date's precision.
target one Entity What an action is directed toward, as distinct from the object it is carried out on. Adding to or removing from a collection targets the collection. A movement targets where it ended, and its object is where it began.
timestamp one DateTime When the action occurred.
From Base
source one Text The source that describes the entity or action, such as things-todo. Identifiers such as sourceId are unique within it.
sourceId one Text The identifier the source gives an entity or action, such as a record ID or message ID. It is unique only within its source.

Examples

Reacting to a message

Alex reacted to your direct message with a heart.

{
  "@type": "RespondAction",
  "@key": [
    "@type",
    "source",
    "object.sourceId",
    "agent.handle",
    "agent.name",
    "result.body"
  ],
  "source": "instagram",
  "timestamp": "2023-11-14T22:15:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "instagram",
    "handle": "alexchen",
    "url": "https://www.instagram.com/alexchen"
  },
  "object": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "instagram",
    "sourceId": "alexchen_123/1700000000000",
    "body": "hello"
  },
  "result": {
    "@type": "Response",
    "@key": [
      "@type",
      "source",
      "body",
      "action.object.sourceId",
      "action.agent.handle",
      "action.agent.name"
    ],
    "source": "instagram",
    "body": "❤️"
  }
}

Replying in a Hacker News thread

You replied to Riley's comment on Alex's story.

{
  "@type": "RespondAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "hackernews",
  "timestamp": "2024-05-06T12:53:20.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "hackernews",
    "handle": "sam",
    "url": "https://news.ycombinator.com/user?id=sam",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Comment",
    "@key": ["@type", "source", "sourceId"],
    "source": "hackernews",
    "sourceId": "40000108",
    "url": "https://news.ycombinator.com/item?id=40000108",
    "body": "And patience.",
    "author": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "hackernews",
        "handle": "riley",
        "url": "https://news.ycombinator.com/user?id=riley"
      }
    ],
    "about": [
      {
        "@type": "Post",
        "@key": ["@type", "source", "sourceId"],
        "source": "hackernews",
        "sourceId": "40000100",
        "url": "https://news.ycombinator.com/item?id=40000100",
        "name": "Sourdough at altitude"
      }
    ]
  },
  "result": {
    "@type": "Comment",
    "@key": ["@type", "source", "sourceId"],
    "source": "hackernews",
    "sourceId": "40000110",
    "url": "https://news.ycombinator.com/item?id=40000110",
    "body": "So much patience.",
    "about": [
      {
        "@type": "Post",
        "@key": ["@type", "source", "sourceId"],
        "source": "hackernews",
        "sourceId": "40000100",
        "url": "https://news.ycombinator.com/item?id=40000100",
        "name": "Sourdough at altitude"
      }
    ]
  }
}

Endorsing a skill

A RespondAction for a LinkedIn skill endorsement: you vouched that Alex has a skill.

{
  "@type": "RespondAction",
  "@key": ["@type", "source", "agent.handle", "object.handle", "result.body"],
  "source": "linkedin",
  "timestamp": "2024-03-02T15:10:00.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle"],
    "source": "linkedin",
    "handle": "sam-rivera",
    "name": "Sam Rivera",
    "url": "https://www.linkedin.com/in/sam-rivera",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Person",
    "@key": ["@type", "source", "handle"],
    "source": "linkedin",
    "handle": "alex-chen",
    "name": "Alex Chen",
    "url": "https://www.linkedin.com/in/alex-chen"
  },
  "result": {
    "@type": "Response",
    "@key": ["@type", "source", "action.agent.handle", "action.object.handle", "body"],
    "source": "linkedin",
    "body": "Interaction Design",
    "about": [
      {
        "@type": "DefinedTerm",
        "@key": ["@type", "source", "name"],
        "source": "linkedin",
        "name": "Interaction Design"
      }
    ]
  }
}

Reacting to a post

A reaction that carries content is a RespondAction.

{
  "@type": "RespondAction",
  "@key": ["@type", "source", "timestamp", "agent.name", "object.url", "result.body"],
  "source": "facebook",
  "timestamp": "2026-05-09T18:23:07.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source"],
    "source": "facebook",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Post",
    "@key": ["@type", "source", "url"],
    "source": "facebook",
    "url": "https://www.facebook.com/alex.morgan.example/posts/555000222",
    "author": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "name"],
        "source": "facebook",
        "name": "Alex Morgan"
      }
    ]
  },
  "result": {
    "@type": "Response",
    "@key": [
      "@type",
      "source",
      "body",
      "action.timestamp",
      "action.agent.name",
      "action.object.url"
    ],
    "source": "facebook",
    "body": "love"
  }
}

Commenting on a post

A comment is a RespondAction whose result is a Comment, the Response that carries prose.

{
  "@type": "RespondAction",
  "@key": ["@type", "source", "timestamp", "agent.name", "result.body"],
  "source": "facebook",
  "timestamp": "2026-05-09T18:24:07.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "name"],
    "source": "facebook",
    "name": "Sam Rivera",
    "sameAs": ["@me"]
  },
  "result": {
    "@type": "Comment",
    "@key": ["@type", "source", "body"],
    "source": "facebook",
    "body": "Great photo",
    "author": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "name"],
        "source": "facebook",
        "name": "Sam Rivera",
        "sameAs": ["@me"]
      }
    ]
  }
}

URI https://schema.chronicle.app/RespondAction · Suggest a change

Esc

↑↓ to move↵ to open/ or ⌘K to search