Skip to main content
API reference sections

Schema

AttributeRowValue

One attribute on one row, as the projection carries it: the value's shape in kind and its canonical string in value.

kind is one of date, datetime_floating, datetime_zoned, number, bool, ref, url, text - three temporal tokens, and no `datetime` that might be either ([ADR-183]). value is the canonical string for that kind: a calendar date as YYYY-MM-DD, a floating wall clock as YYYY-MM-DDTHH:MM:SS, a zoned instant as decimal epoch-ms, a tag as its TagId.

[ADR-183]: ../../../docs/decisions/ADR-201-225.md#adr-206-timemodel--koru-has-three-temporal-types-not-one-with-a-nullable-timezone

Type object

Shape

FieldTypeDescription
idrequiredstring

The attr record's own id, stable across edits to its value.

rolerequiredstring

The attribute key the value is stored under - koru.due, koru.tag, or a custom definition's key.

kindrequiredstring
valuerequiredstring
zonestring or null

The IANA zone a datetime_zoned value was meant in, and absent for every other kind.

It travels with the instant rather than being dropped as presentation: a consumer handed an epoch-ms number alone would be holding the ambiguous shape the three types exist to abolish. Which zone a reader displays it in is that consumer's own, separate decision.

labelstring or null

Default null

Example
{
  "id": "string",
  "role": "string",
  "kind": "string",
  "value": "string",
  "zone": "string",
  "label": "string"
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated .

Privacy choices

Choose which optional tools Koru may use on this site. Your choice is saved in a cookie in this browser for 12 months. Privacy policy

Privacy choices

Keep you signed in, protect forms and remember your language and this choice.

Always on

PostHog and Google Analytics 4 measure page views and actions such as downloads, using cookies or local storage.

PostHog records how pages are used, with form inputs masked and private pages excluded. Needs Analytics.

Ahrefs Web Analytics measures visits and where they come from, and Google Ads measures whether our ads led to a visit or download.