List observable Scopes

GET
/v1/scopes

Inspect available Scopes for an explicit navigation or organization request. Do not enumerate Scopes to bypass the current session binding or search another work context implicitly. Reuse the host-selected Scope for ordinary data-plane operations. Discover Scope descriptors with an explicit literal-substring field and exact relationship filters. Query matches the selected original field using the database's native substring operation. Regular expressions and wildcard syntax are not supported. Case, accent, and full-width/half-width matching follow the underlying database collation; results need not be identical across backends. Requests without query parameters preserve the existing complete-list behavior.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Query Parameters

query?string
Lengthlength <= 256
query_field?string

Value in

  • "scope_id"
  • "title"
  • "summary"
  • "external_reference_value"
  • "binding_external_id"
parent_scope_id?string
Match.*\S.*
Length1 <= length <= 256
external_reference_kind?string
Match.*\S.*
Length1 <= length <= 128
binding_integration?string
Match.*\S.*
Length1 <= length <= 128
binding_kind?string
Match.*\S.*
Length1 <= length <= 64
limit?integer
Range1 <= value <= 100
Default50
cursor?string
Length1 <= length <= 4096

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/scopes"
{  "items": [    {      "scope_id": "string",      "title": "string",      "summary": "string",      "parent_scope_id": "string",      "context_references": [        "string"      ],      "external_references": [        {          "kind": "string",          "value": "string"        }      ],      "version": 1    }  ],  "next_cursor": "string"}

Get runtime capabilities GET

Previous Page

Create an independent Scope boundary POST

Create a Scope only for a user-established independent result boundary with known Parent and references. Ordinary recall, search, or saving does not create a Scope. Never invent Scope identities from a directory or branch. Creation alone does not bind the current host session.