GET /api/v1/{context_id}/scopes

Changed on Aug 24, 2026

List the Context's registered scope nodes (live and tombstoned). Only nodes the caller has a grant over are returned (scope:read, or any other verb in the region); a grant:manage holder over / sees the whole tree. Paginated: follow page.nextCursor. Visibility filtering happens after the page bound, so a page can be short while page.hasMore is still true.

Request

The document declares no server URL.
Auth
HTTP bearer
TypeScript
https://skmtc.dev/surrealdb/apis/spectron/docs/api/v1/:context_id/scopes/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

context_idstring required

Spectron context id

Query parameters

limitinteger

Max nodes to scan per page (default 100, max 500)

cursorstring

Continuation token from the previous page's page.nextCursor

Response

Changes

Aug 24, 20269f1598713067 Revision changes
- breaking
  the response's body type changed from array to object for status
- info
  added the new optional query request parameter cursor
- info
  added the new optional query request parameter limit
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history