Primitive
atom.list
BETAShort name: list
Version: 1.0.0
System primitive that queries atoms visible to the authenticated user. Supports filtering by lexeme, scope, visibility, and organization. Returns a paginated array of serialized atoms.
Back to primitive libraryInputs
| Key | Type | Required | Description |
|---|---|---|---|
| isPublic | boolean | false | Filter by public visibility. true = only public atoms, false = only private atoms. Omit for no filter. |
| lexemeId | objectId | false | Filter to atoms subscribed to this lexeme. Omit to return atoms of any lexeme. |
| limit | number | false | Results per page. Defaults to 20; maximum 100. |
| organizationAtomId | objectId | false | Scope results to atoms owned by a specific organization atom. User must be a member or admin. |
| page | number | false | 1-indexed page number. page=1 returns items 1–limit, page=2 returns items (limit+1)–(2*limit), etc. Defaults to 1. |
| personalOnly | boolean | false | When true, excludes organization-owned atoms and returns only personally owned atoms. |
| sandboxSessionId | string | false | Opt-in: when set, returns ONLY atoms tagged with this sandbox session id. When omitted, sandboxed atoms are excluded from results. |
| scope | string | false | Visibility scope: "own" (atoms you own or manage, default), "share" (atoms explicitly shared with you), or "all" (all visible atoms). |
Outputs
| Key | Type | Required | Description |
|---|---|---|---|
| atoms | array | false | Serialized atom objects matching the query. Private fields are stripped for non-managers. |
| pagination | object | false | Pagination metadata: { page, limit, total, totalPages }. |