Labeling Curation

List curation vault labels

Publicly reads the latest published vault-label snapshot by default. Explicit current or draft reads expose the mutable working copy. Platform operators can read every entity; entity-member sessions are restricted to their own entity. These table-backed resources use /v3/curation so the pre-existing API-key-scoped /v3/curator contract remains backward compatible.

get/v3/curation/vaults

Query parameters

labelSetstring

Label set identifier. Defaults to public.

versionstring

Version selector. Omission, latest, and production select the latest published snapshot. Explicit current and draft select the mutable working copy and require an authorized session as documented by the endpoint. Other published keys and aliases retain their stored casing.

limitinteger

Requested page size. Values above the endpoint cap are clamped; the default shared cap is 100.

offsetinteger
chainIdinteger
entityIdstring
view'curation' | 'resolved'

Read view. curation (default) returns raw label fields with the resolved block nested, mirroring the write schema so read-modify-write round-trips stay safe. resolved returns the display cascade flattened to the top level with raw fields omitted, for read-only consumers. Unknown values are rejected with 400.

vaultTypestring

Comma-separated vault-type filter (evk,earn,securitize,escrow). Defaults to all vault types; unknown values are rejected.

Response

Vault-label page. Item shape follows the view parameter.

Changes