SystemMetadata

System-managed metadata that is automatically added to records.

Table

Property	Type	Required	Description
createdAt	utcDateTime	Yes	The timestamp (in UTC) at which the record was created
lastModifiedAt	utcDateTime	Yes	The timestamp (in UTC) at which the record was last modified

Formats

Example

A JSON example of this model.

{
  "createdAt": "2024-02-28T12:00:00Z",
  "lastModifiedAt": "2024-02-28T12:00:00Z"
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: SystemMetadata.yaml
type: object
properties:
  createdAt:
    type: string
    format: date-time
    description: The timestamp (in UTC) at which the record was created.
  lastModifiedAt:
    type: string
    format: date-time
    description: The timestamp (in UTC) at which the record was last modified.
required:
  - createdAt
  - lastModifiedAt
examples:
  - createdAt: 2025-01-01T17:01:01
    lastModifiedAt: 2025-01-02T17:30:00
description: Standard system-level metadata about a given record.

TypeSpec

The TypeSpec code for this model.

@example(Examples.Metadata.system)
model SystemMetadata {
  /** The timestamp (in UTC) at which the record was created. */
  @visibility(Lifecycle.Read)
  createdAt: utcDateTime;

  /** The timestamp (in UTC) at which the record was last modified. */
  @visibility(Lifecycle.Read)
  lastModifiedAt: utcDateTime;
}