Skip to navigation

List objects of a definition in a space

View as Markdown

Lists the objects (records) of a definition within a space. Authorization: requires space:read on :spaceId — a caller who lacks it gets 404 (leak-guard, not 403). Query params: filter — a JSON array of filter entries ({ fieldKey, subField?, operand, value }, 14 operands); sort — a JSON array of sort entries ({ fieldKey, direction: asc|desc }); view — a saved-view id whose stored filters/sorts are applied instead, mutually exclusive with filter/sort (400 invalid_request); limit (1–200, default 50) and offset (default 0) for pagination. Default sort is createdAt desc. Unknown/archived field or a $-injection in filter/sort → 422; an unknown/wrong-scope view → 404 view_not_found. Returns { objects, nextOffset } — nextOffset is the offset of the next page or null when exhausted; each object carries inline data, fieldMeta, (when AI-imported) provenance/review, and (when produced by an action run) an origin { actionRunId?, playbookRunId? }.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired
definitionIdstringRequired

Query parameters

filterstringOptional

Ad-hoc filter: a JSON array of { fieldKey, subField?, operand, value } entries.

sortstringOptional

Ad-hoc sort: a JSON array of { fieldKey, direction } entries.

viewstringOptional

A saved-view id whose stored filters and sorts are applied instead. Mutually exclusive with filter and sort.

limitintegerOptional1-200Defaults to 50

Page size, 1–200.

offsetintegerOptional>=0Defaults to 0
Row offset.

Response

A page of objects.
objectslist of objects
nextOffsetdouble or null
Offset of the next page, or null when the list is exhausted.

Errors

400
Bad Request Error
404
Not Found Error
422
Unprocessable Entity Error