ChronicleSchema

In other vocabularies

VocabularyTerm
schema.org A kind of Action
Activity Streams 2.0 A kind of Activity

Properties

PropertyExpected typeDescription
Properties of 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.

Subclasses

AcceptAction The agent accepted what was put forward, such as merging a changeset into the work it changes. AssessAction The agent took a stance on the object, such as by liking, reacting to, rating, or reviewing it. CancelAction The agent withdrew a plan or intended activity, such as a task. CompleteAction The agent finished an activity or piece of work, such as a task or a book. ConsumeAction The agent took in the object, such as by reading, watching, listening to, eating, or drinking it. CreateAction The agent brought a work into being. DeleteAction The agent removed an entity from its source, such as by moving an item to the trash. ExecuteAction The agent ran a command or a piece of software. ExperienceAction The subject went through a period of life or a life event, such as a logged block of time, a job, or a relationship. FindAction The agent searched on a platform. InteractAction The agent engaged with others, such as by communicating with them or following them. MeasureAction The agent took a measurement of the object, such as a person's heart rate or weight. MessageAction The agent sent a message. MoveAction The agent moved from the object to the target. OrganizeAction The agent arranged or planned things, such as by saving, bookmarking, or scheduling. PlanAction The agent decided to do something, such as by creating a to-do item. RejectAction The agent declined what was put forward, such as closing a changeset without taking it in. TradeAction The agent exchanged something of value with another agent, such as by buying, selling, or paying. TravelAction The agent travelled from the object place to the target place, from startTime to endTime. UpdateAction The agent changed an existing entity, such as by editing a task's title or notes. VisitAction The agent stayed at the object place from startTime to endTime.

Examples

Running a shell command

An ExecuteAction for one command from shell history.

{
  "@type": "ExecuteAction",
  "@key": [
    "@type",
    "source",
    "timestamp",
    "object.body",
    "agent.handle",
    "agent.memberOf[*].handle"
  ],
  "source": "shell",
  "timestamp": "2026-03-14T09:26:53.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle", "memberOf[*].handle"],
    "source": "shell",
    "handle": "sam",
    "memberOf": [
      {
        "@type": "Realm",
        "@key": ["@type", "source", "handle"],
        "source": "hostname",
        "handle": "studio"
      }
    ],
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Command",
    "@key": ["@type", "source", "body", "action.timestamp"],
    "source": "shell",
    "body": "git log --oneline -5"
  }
}

Completing a to-do

A CompleteAction for a finished Task.

{
  "@type": "CompleteAction",
  "@key": ["@type", "source", "object.sourceId"],
  "source": "things-todo",
  "timestamp": "2026-04-02T17:45:10.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source"],
    "source": "things-todo",
    "name": "Sam Rivera",
    "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.",
    "isPartOf": [
      {
        "@type": "Project",
        "@key": ["@type", "source", "sourceId"],
        "source": "things-todo",
        "sourceId": "Hq4mVz7Ns2Ck8Ew5Ty1Lp",
        "name": "Trip to Lisbon"
      },
      {
        "@type": "Collection",
        "@key": ["@type", "source", "sourceId"],
        "source": "things-todo",
        "sourceId": "Ua6Rj3Mf9Xs2Gb7Kd4Wn8e",
        "name": "Personal"
      }
    ],
    "about": [
      {
        "@type": "Tag",
        "@key": ["@type", "source", "sourceId"],
        "source": "things-todo",
        "sourceId": "Zc1Fy8Pq5Hv3Ln6Jt2Bs9o",
        "handle": "errands",
        "name": "errands"
      }
    ]
  }
}

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

Esc

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