Skip to main content
PATCH
Edit a store record

Authorizations

X-API-Key
string
header
required

Path Parameters

store
string
required
key
string
required

Body

application/json

A manual edit to one record.

The values you send replace your manual assertions on this record wholesale: a field you omit stops being asserted manually, and resolution falls through to the next source that asserts it. Send {} to withdraw every manual assertion.

The edit is written as the manual layer and obeys the same rules as every other source — your precedence decides whether it wins a field, and a field your precedence excludes manual from is refused rather than stored where it could never be read.

layer_data
Layer Data · object
required

The values you assert for this record. Every key must be a field the store declares and that your precedence allows manual to write.

Response

Successful Response

One record of a store: its resolved view, and optionally its layers.

resolved is the single view computed from the record's layers by your precedence. Request include=layers to also see each source's own assertions and provenance.

key
string
required

The record's key, in the store's canonical key format.

resolved
Resolved · object
required

The resolved view — one value per field, taken from the highest-precedence source asserting it. A field no source asserts is absent rather than null.

resolved_config_version
integer
required

Which precedence version produced this resolved view. A value behind the store's current config_version means the view is awaiting recompute.

created_at
string<date-time>
required

When the record was first written by any source.

updated_at
string<date-time>
required

When any source last wrote to the record.

layers
Layers · object | null

Each source's own assertions, keyed by source name. Present only when include=layers was requested.