Aggregate objects
Counts, sums or averages one declared type's records, grouped by up to three declared properties and narrowed by the type's own list filters. The rows are the ones the type's list returns to this caller, so drafts it cannot see, other galleries and anything access rules hide are never counted. A key needs the scopes of the type's named list: `artworks:read` and `artists:read` for `artwork`, `locations:read` for `location`, `contacts:read` for `party`, `artists:read` for `artist`, `shows:read` for `booth`, `artworks:update` and `contacts:read` for `hold`; without them the answer is 403. Refusals answer 400 with `details.reason`: `withheld` for a withheld property, `restricted` for a property the caller's role cannot read, `hidden_from_key` for a field a read-only key's reads hide, `not_numeric` for a sum or average over a non-numeric property, `currency_required` for a money sum not grouped by its currency, `unknown_type`, `not_readable` for a type with no list read, `unknown_property`, `not_groupable`, `unknown_filter`, `invalid_filter`, `duplicate`, and `group_restricted` for a party property outside `kind`, `contact_type`, `lead_status` and `do_not_email`, since a party's text values are never group keys, for an artist property other than `visibility`, for a booth property other than `show_id`, `hall` and `sector`, and for a hold property other than `artwork_id`, `party_id`, `ends_on` and `released_reason`. A scan reads a bounded number of rows; `capped` says when a cap cut the answer.
Counts, sums or averages one declared type's records, grouped by up to three declared properties and narrowed by the type's own list filters. The rows are the ones the type's list returns to this caller, so drafts it cannot see, other galleries and anything access rules hide are never counted. A key needs the scopes of the type's named list: artworks:read and artists:read for artwork, locations:read for location, contacts:read for party, artists:read for artist, shows:read for booth, artworks:update and contacts:read for hold; without them the answer is 403. Refusals answer 400 with details.reason: withheld for a withheld property, restricted for a property the caller's role cannot read, hidden_from_key for a field a read-only key's reads hide, not_numeric for a sum or average over a non-numeric property, currency_required for a money sum not grouped by its currency, unknown_type, not_readable for a type with no list read, unknown_property, not_groupable, unknown_filter, invalid_filter, duplicate, and group_restricted for a party property outside kind, contact_type, lead_status and do_not_email, since a party's text values are never group keys, for an artist property other than visibility, for a booth property other than show_id, hall and sector, and for a hold property other than artwork_id, party_id, ends_on and released_reason. A scan reads a bounded number of rows; capped says when a cap cut the answer.
A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "type": "artwork", "group_by": [ "string" ], "measures": [ "string" ], "groups": [ { "key": { "property1": null, "property2": null }, "values": { "property1": 0, "property2": 0 } } ], "matched": -9007199254740991, "method": "count", "scanned": -9007199254740991, "caps": { "rows": -9007199254740991, "groups": -9007199254740991 }, "capped": { "rows": true, "groups": true }}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}List gallery movements GET
The gallery's recent artwork movements, newest first, with cursor pagination. Each entry carries its artwork's title and inventory number. Defaults to the last 90 days; pass `since` (an ISO date or datetime) to reach further back.
Get an object GET
Returns one object by its public id, whatever its type: the id prefix names the type, and the answer is that type's own read, with the same access and field visibility. A key needs the scopes of the type's named read: `artworks:read` and `artists:read` for an artwork, `locations:read` for a location, `contacts:read` and `gallery:read` for a party, `artists:read` for an artist, `shows:read` for a booth, `artworks:update` and `contacts:read` for a hold; without them the answer is 403. `expand` follows the named links one level, and each far-end type needs its own read scopes too. An id whose prefix no declared type owns answers 404, and so does a merged-away party or artist id; a declared type with no read answers 400 with `details.reason` `not_readable`.