UpdateAction · Chronicle Schema

Properties

Property	Expected type	Description
From Action
agent one	Agent	The doer of the action, when identified by the source. Omit when no doer is known; an occurrence can be recorded without an agent.
instrument one	Entity	The tool, device, application, or model used to perform an action. The agent identifies who acted; instrument identifies what they used.
object one	Entity	The entity an action is carried out on, such as the article being read, the message being sent, or the place being visited. For movement, the object identifies where the movement began.
timestamp one	DateTime	The instant when the action occurred, as reported by the source. Records occurrence time, not the time Chronicle extracted the record.
From Base
source one	Text	The source system that describes the entity or action, such as things-todo. Provides the source namespace in which identifiers such as sourceId are interpreted.
sourceId one	Text	The identifier assigned by the source to an entity or action, such as a record ID or message ID. Represented as text and scoped to the source's own namespace; it need not be globally unique.

Examples

Editing a to-do

An UpdateAction for editing a Task.

{
  "@type": "UpdateAction",
  "@key": ["@type", "source", "sourceId"],
  "source": "things-todo",
  "sourceId": "5nT2kQv8Lw3xRb1YcHd9pA",
  "timestamp": "2026-03-28T19:03:44.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source"],
    "source": "things-todo",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Task",
    "@key": ["@type", "source", "sourceId"],
    "source": "things-todo",
    "sourceId": "5nT2kQv8Lw3xRb1YcHd9pA",
    "name": "Renew passport",
    "description": "Two photos are in the top desk drawer."
  }
}

{
  "@context": {
    "@vocab": "https://schema.chronicle.app/",
    "doc": "https://schema.chronicle.app/docs/"
  },
  "@type": "UpdateAction",
  "doc:key": {
    "@list": ["@type", "source", "sourceId"]
  },
  "source": "things-todo",
  "sourceId": "5nT2kQv8Lw3xRb1YcHd9pA",
  "timestamp": {
    "@value": "2026-03-28T19:03:44.000Z",
    "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
  },
  "agent": {
    "@type": "Agent",
    "doc:key": {
      "@list": ["@type", "source"]
    },
    "source": "things-todo",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Task",
    "doc:key": {
      "@list": ["@type", "source", "sourceId"]
    },
    "source": "things-todo",
    "sourceId": "5nT2kQv8Lw3xRb1YcHd9pA",
    "name": "Renew passport",
    "description": "Two photos are in the top desk drawer."
  }
}

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

[
  a :UpdateAction;
  doc:key ("@type" "source" "sourceId");
  :source "things-todo";
  :sourceId "5nT2kQv8Lw3xRb1YcHd9pA";
  :timestamp "2026-03-28T19:03:44.000Z"^^xsd:dateTime;
  :agent [
    a :Agent;
    doc:key ("@type" "source");
    :source "things-todo";
    :sameAs "@me"
  ];
  :object [
    a :Task;
    doc:key ("@type" "source" "sourceId");
    :source "things-todo";
    :sourceId "5nT2kQv8Lw3xRb1YcHd9pA";
    :name "Renew passport";
    :description "Two photos are in the top desk drawer."
  ]
] .

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