Register a scope node (auto-vivifies missing ancestors; enforces scope:create, depth, node-budget, and per-node policy).

post/api/v1/{context_id}/scopes

Path parameters

context_idstring required

Spectron context id

Request body

descriptionstring nullable

Optional description for the UI.

displayNamestring nullable

Optional display name for the UI.

pathstring required

A validated, canonical scope path in slash form, e.g. org/apple/product/ipad/. Root is /. A leading and a trailing / are both optional on input (/org/apple, org/apple/ and org/apple all denote the same node); the canonical form returned carries the trailing / and no leading one.

Response

createdAtstring date-time required

Creation timestamp.

pathstring required

A validated, canonical scope path in slash form, e.g. org/apple/product/ipad/. Root is /. A leading and a trailing / are both optional on input (/org/apple, org/apple/ and org/apple all denote the same node); the canonical form returned carries the trailing / and no leading one.

tombstonedAtstring date-time nullable

Soft-delete timestamp; null while the node is live.

Changes

Changed in 1 of the 5 revisions of this API.1