Docmost Octri Preview
POST/bases

List bases in a space

Bases the caller cannot access are filtered out after pagination, so items can be shorter than limit - even empty - while meta still describes the unfiltered page. Treat hasNextPage as the signal to keep going, not an empty items.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 body fields
spaceIdstringrequired
Space identifier (UUID).
adminViewbooleanoptional
If `true`, the list includes all items the admin has global permissions to access by virtue of their admin role.
beforeCursorstringoptional
Set to `prevCursor` from the previous call to list the previous page. Ignored when `cursor` is also supplied.
cursorstringoptional
Set cursor to `nextCursor` returned by the previous call to list items in the next page.
limitintegeroptional
Maximum number of items to return per page.
Default:20
querystringoptional
Optional text filter to search within the listed items (e.g. filter members by name).

2 status codes
200Paginated bases the caller can access
dataobjectoptional
statusintegeroptional
successbooleanoptional
403Forbidden
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 403 is returned: Forbidden.