Skip to content

Commit bb07931

Browse files
committed
chore(spec): regenerate the reference docs for the planned names marker
Claude-Session: https://claude.ai/code/session_01WGufzik1dDv4DzrV1fWBV9 Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 8b17a59 commit bb07931

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

‎content/docs/references/api/protocol.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1514,7 +1514,7 @@ One changed key path of the pending draft, and the last write that changed it.
15141514
| :--- | :--- | :--- | :--- |
15151515
| **type** | `string` | ✅ | Metadata type name (e.g., "object", "plugin") |
15161516
| **packageId** | `string` | optional | Optional package ID to filter items by |
1517-
| **names** | `string[]` | optional | Item names to narrow the list to: only the named items of the type are answered, among those the list would answer without it. Sent over HTTP as one comma-separated value (`?names=a,b,c`). A name that matches no item is simply absent from the answer (no 404). An empty value is refused with 400 rather than read as every item; leave the key out to list every item. |
1517+
| **names** | `string[]` | optional | [PLANNED — not yet served] Item names to narrow the list to: only the named items of the type are answered, among those the list would answer without it. Sent over HTTP as one comma-separated value (`?names=a,b,c`). A name that matches no item is simply absent from the answer (no 404). An empty value is refused with 400 rather than read as every item; leave the key out to list every item. No list door reads it yet: until one does, a request carrying it is answered as if it were absent. |
15181518
| **previewDrafts** | `boolean` | optional | Draft-visibility switch (ADR-0033 draft-overlay preview): when true, pending `state='draft'` rows are overlaid on the active list — draft wins on name collision, draft-only items appear, and each overlaid item is tagged `_draft: true` so UIs can badge the preview. Absent/false = published world only. Declaration ≠ authorization: this member only switches which rows are read, and ADR-0106 masking is unaffected — callers without draft-preview authorization are refused upstream (admin-gated), not by this schema. |
15191519

15201520

0 commit comments

Comments
 (0)