Date Time Item object representation

The datetimeitem object representation and fields are described below.

datetimeitem was introduced in API version V1

datetimeitem has not been marked for deprecation

Endpoint usages

Description

Date time represented as ISO 8601 with milliseconds

Example create representation

{
  "entity" : {
    "urn" : "4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d",
    "url" : "/n/v1/entity/4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d"
  },
  "name" : "birthday",
  "sortOrder" : 0,
  "value" : "2025-07-14T09:00:00.000"
}

Example response representation

{
  "urn" : "5841a247-9ecc-4f15-921a-7c1a2573cb2b",
  "url" : "/n/v1/datetimeitem/5841a247-9ecc-4f15-921a-7c1a2573cb2b",
  "entity" : {
    "urn" : "4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d",
    "url" : "/n/v1/entity/4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d"
  },
  "name" : "birthday",
  "sortOrder" : 0,
  "value" : "2025-07-14T09:00:00.000"
}

Fields

NameTypeDescriptionConstraints
urnString representation of a Unique Resource Name. Typically a UUID with 36 characters.Minimum length: 36. Maximum length: 36.
urlURL represented as a string
entityEntityThe entity associated with this date time itemRequired on create.
nameField name, typically used in content items. Typically use conventions around html ID expectations.Name for the field e.g. meta_title. Fields can be arbitrary. Suggest using JS like field namesRequired on create. Maximum length: 1024.
sortOrderSigned int32Field sorting order for field orderingRequired on create.
valueString literalA date time value expressed in UTC formatted as ISO 8601 date time with millisecondsRequired on create.
isPublishedBoolean literal e.g. trueSet in the context if date time item history to indicate which of the items is published.
createdTimestampTimestamp expressed in ISO 8601 format without timezone including milliseconds. Note unless otherwise stated in UTC zone.The timestamp the date time was created in history view
historyDate / Time item historyThe history of this date time item