ChronicleSchema

PlanAction

The act of establishing an intention to do something, such as creating a to-do item. The object identifies the planned work; the timestamp records when the plan was made.

Properties

PropertyExpected typeDescription
From Action
agent oneAgentThe doer of the action, when identified by the source. Omit when no doer is known; an occurrence can be recorded without an agent.
instrument oneEntityThe tool, device, application, or model used to perform an action. The agent identifies who acted; instrument identifies what they used.
object oneEntityThe 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 oneDateTimeThe instant when the action occurred, as reported by the source. Records occurrence time, not the time Chronicle extracted the record.
From Base
source oneTextThe 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 oneTextThe 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

Creating a to-do

A PlanAction for creating a Task.

{
  "@type": "PlanAction",
  "@key": ["@type", "source", "sourceId"],
  "source": "things-todo",
  "sourceId": "5nT2kQv8Lw3xRb1YcHd9pA",
  "timestamp": "2026-03-20T08:12:31.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"
  }
}

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

Esc

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