ChronicleSchema

In other vocabularies

VocabularyTermHow they differ
schema.org A kind of CreateAction
Activity Streams 2.0 A kind of Create The work created is the result. In an as:Create, it is the as:object.

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.

Subclasses

Examples

Writing a comment

You commented on a post.

{
  "@type": "CreateAction",
  "@key": ["@type", "source", "object.references[*].handle", "object.body", "timestamp"],
  "source": "instagram",
  "timestamp": "2024-05-06T12:53:20.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "instagram",
    "handle": "sam.rivera",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Comment",
    "@key": ["@type", "source", "references[*].handle", "body", "action.timestamp"],
    "source": "instagram",
    "body": "Congrats!",
    "references": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "instagram",
        "handle": "alexchen",
        "url": "https://www.instagram.com/alexchen"
      }
    ]
  }
}

An account being registered

A CreateAction for the day a Last.fm account was registered.

{
  "@type": "CreateAction",
  "@key": ["@type", "source", "result.handle"],
  "source": "lastfm",
  "timestamp": "2012-03-14T16:20:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "lastfm",
    "handle": "alex_plays"
  },
  "result": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "lastfm",
    "handle": "alex_plays"
  }
}

Creating a playlist

A CreateAction for a YouTube playlist, at the time the playlist was created.

{
  "@type": "CreateAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "youtube",
  "timestamp": "2024-02-20T19:45:10.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "youtube",
    "handle": "UCexampleOwner0000000000",
    "sameAs": ["@me"]
  },
  "result": {
    "@type": "Collection",
    "@key": ["@type", "source", "sourceId"],
    "source": "youtube",
    "sourceId": "PLexample0001",
    "url": "https://www.youtube.com/playlist?list=PLexample0001",
    "name": "Bike repair",
    "visibility": "unlisted"
  }
}

Creating an Are.na channel

You created a channel on Are.na.

{
  "@type": "CreateAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "arena",
  "timestamp": "2024-12-01T00:00:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "sourceId"],
    "source": "arena",
    "sourceId": "1",
    "handle": "pat-example",
    "name": "Pat Example",
    "sameAs": ["@me"]
  },
  "result": {
    "@type": "Collection",
    "@key": ["@type", "source", "sourceId"],
    "source": "arena",
    "sourceId": "11",
    "name": "Shared reading",
    "url": "https://www.are.na/pat-example/shared-reading",
    "visibility": "public"
  }
}

Commenting on an Are.na block

You left a comment on Alex's block.

{
  "@type": "CreateAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "arena",
  "timestamp": "2025-01-04T00:00:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "sourceId"],
    "source": "arena",
    "sourceId": "1",
    "sameAs": ["@me"]
  },
  "result": {
    "@type": "Comment",
    "@key": ["@type", "source", "sourceId"],
    "source": "arena",
    "sourceId": "30",
    "body": "Nice",
    "author": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "sourceId"],
        "source": "arena",
        "sourceId": "1"
      }
    ],
    "about": [
      {
        "@type": "Post",
        "@key": ["@type", "source", "sourceId"],
        "source": "arena",
        "sourceId": "21",
        "url": "https://www.are.na/block/21",
        "body": "Hello from Alex",
        "author": [
          {
            "@type": "Agent",
            "@key": ["@type", "source", "sourceId"],
            "source": "arena",
            "sourceId": "2",
            "handle": "alex-example",
            "name": "Alex Example"
          }
        ]
      }
    ]
  }
}

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

Esc

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