Skip to main content
GET
Get a data store

Authorizations

X-API-Key
string
header
required

Path Parameters

store
string
required

Response

Successful Response

Everything one store declares, plus the precedence in effect for you.

The field map is the store's own type declaration, so a form or table can be rendered from this response alone — including which values are allowed, which may be null, and how each value should be handled.

slug
string
required

Identifies the store in every store URL.

tier
string
required

Which kind of store this is.

version
integer
required

Version of the store's platform declaration.

record_key
StoreRecordKeyResponse · object
required

How a store's record key is formed.

fields
Fields · object
required

Every field the store declares, keyed by field name.

sources
string[]
required

Every source that may ever write a layer to this store.

precedence
StorePrecedenceResponse · object
required

The precedence currently deciding this store's resolved values.

For each field, the first source in that field's order which asserts a value wins. A field's order is also the list of sources allowed to write it, so one place answers both "who wins" and "who may say anything at all".

config_version
integer
required

Version of your precedence settings. Every record records the version its resolved view was computed with, which is what makes a view left behind by a precedence change detectable.

recompute
StoreRecomputeResponse · object
required

Whether every record's resolved view reflects the current precedence.

Changing precedence invalidates the resolved views computed under the old settings, and they are recomputed in the background. While that is running, bulk queries legitimately mix records resolved under the old precedence with records resolved under the new one. pending reaching zero is how you know the window has closed.

changed_event_type
string
required

The event emitted when a record's resolved value changes. Subscribe to this exact name to react to changes.

summary_event_type
string
required

The event emitted once per completed sync, carrying that sync's totals. Subscribe to this one for bulk reactions.

record_retention_days
integer | null

How long records are kept. Null means indefinitely.

history_retention_days
integer | null

How long history rows are kept. Null means indefinitely.