ZeroWidth Prism

Search ZeroWidth product documentation. Returns matching pages with title, slug, public URL, and a query-relevant snippet. Use this when the user asks about a ZeroWidth product (Compass, Workbench, Caliper, Prism, Ledger, Napkin, zv1), an API behavior, or a policy. No authentication required — the docs corpus is public.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search query — keywords or natural-language phrase."
    },
    "limit": {
      "default": 10,
      "description": "Max number of results. Defaults to 10.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch the full Markdown body of a specific docs page by its slug. Use this after `search_docs` when the user needs the complete content of a page. No authentication required.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Page slug. Accepts 'compass/api', '/compass/api', or 'docs/compass/api'."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Enumerate all available docs pages, optionally filtered by product (e.g. 'compass', 'legal', 'overview'). Use this to discover what slugs exist before calling `get_doc`. No authentication required.

{
  "type": "object",
  "properties": {
    "product": {
      "description": "Optional product slug filter (e.g. 'compass', 'legal', 'overview').",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lists Prism fields (idea-exploration canvases) in the active workspace: name, origin idea, node count. Fetch one with `prism_fields_get` for its nodes.

{
  "type": "object",
  "properties": {
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One field's full tree: every node (id, parent, axis, description, pinned, color, whether it has an image / desk research) plus the AI-clustered groups. The origin node has parentId=null; children sit along named axes. Use node ids with the expand / research / study tools.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field id (from prism_fields_list)."
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "fieldId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cross-instrument findings for one subject (today: a Prism node) — attached feedback studies with response counts + theme counts, and whether desk research exists. (Interviews are study-level now — read them per study with prism_interviews_list.) THE PLACE TO LOOK before proposing new research: cite what already exists.

{
  "type": "object",
  "properties": {
    "subjectType": {
      "type": "string",
      "enum": [
        "prism_node"
      ],
      "description": "Subject type."
    },
    "subjectId": {
      "type": "string",
      "description": "Subject id (e.g. a Prism node id)."
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "subjectType",
    "subjectId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a field from an origin idea — the seed of an exploration canvas. Counts against the workspace's field quota. May return `needs_confirmation` — tell the user what you're proposing and wait for approval.

{
  "type": "object",
  "properties": {
    "visibility": {
      "description": "Who can see it: PRIVATE (only the user), WORKSPACE (every member, the default), or SHARED (specific people, granted afterwards). Say 'make it private' → PRIVATE.",
      "type": "string",
      "enum": [
        "PRIVATE",
        "WORKSPACE",
        "SHARED"
      ]
    },
    "originIdea": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000,
      "description": "The idea at the center — a product, concept, sentence."
    },
    "name": {
      "description": "Display name (defaults to the idea).",
      "type": "string",
      "maxLength": 200
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior needs_confirmation envelope.",
      "type": "string"
    }
  },
  "required": [
    "originIdea"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

THE core Prism gesture: generate variations of a node along a named semantic axis ('more visceral', 'for the skeptic', 'stripped to essentials'…) in one of four directions. Runs generation against the workspace's inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field id."
    },
    "parentId": {
      "type": "string",
      "description": "Node to branch from."
    },
    "axis": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The lens for the variations — short, evocative."
    },
    "count": {
      "description": "How many (default 3).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "direction": {
      "description": "Canvas direction (default right; pick a free side).",
      "type": "string",
      "enum": [
        "up",
        "down",
        "left",
        "right"
      ]
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "fieldId",
    "parentId",
    "axis"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sets pinned state and/or the color tag on a node. Pins are the cross-field shortlist. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string"
    },
    "nodeId": {
      "type": "string"
    },
    "pinned": {
      "type": "boolean"
    },
    "color": {
      "description": "Hex color, or null to clear.",
      "anyOf": [
        {
          "type": "string",
          "pattern": "^#[0-9a-fA-F]{6}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "fieldId",
    "nodeId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Web-sourced secondary research on a node's idea — market context with citations, stored on the node. depth 'thorough' runs three angled passes (market, evidence, shifts) at ~3× the credit. `focus` steers what it goes after; without one it answers a generic brief off the node's own description, so pass it whenever the user has said what they actually want to know. Runs against the workspace's inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string"
    },
    "nodeId": {
      "type": "string"
    },
    "depth": {
      "type": "string",
      "enum": [
        "quick",
        "thorough"
      ]
    },
    "focus": {
      "description": "What to concentrate on, e.g. 'pricing and who already pays for this' or 'regulatory constraints in the EU'.",
      "type": "string",
      "maxLength": 1000
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "fieldId",
    "nodeId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Feedback studies attached to one Prism node: title, question count, response count, open/closed.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string"
    },
    "nodeId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "fieldId",
    "nodeId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One study's questions, response count, open/closed state, and the STORED analysis (summary + themes with strength; insights.activeRun set = an analysis is running right now — wait for it before citing). participantUrl is the live share link to forward when the study is open and one has been minted. Cite theme strengths when reporting results.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generates a short study (5-8 questions probing the node's problem space — respondents never see the idea itself) and creates it as a DRAFT. The user reviews, previews, and opens it for responses from the study page (or via prism_studies_update publish). Runs generation against inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string"
    },
    "nodeId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "fieldId",
    "nodeId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generates and creates a DRAFT study that isn't tied to any canvas node — brand tracking, workspace-level research, anything you can describe in a sentence. It appears on Prism's Studies page; the user previews and opens it for responses there (or via prism_studies_update publish). Runs generation against inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "about": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000,
      "description": "What the study should probe — a topic, question, or problem space in plain language."
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "about"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Qual-first design: drafts a survey GROUNDED in the study's completed interviews — the recurring claims become measurable questions, the tensions become the choices, in the interviewees' own words. Replaces the study's current questions with the draft (nothing fields until publish). Needs at least one completed interview (see prism_interviews_list). An optional steer biases the instrument ('focus on pricing'). Runs generation against inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "steer": {
      "type": "string",
      "maxLength": 2000
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

publish: true takes a draft live (one-way — the participant link starts working). closed toggles whether a live study accepts responses. Also edits the study: title, the `questions` instrument (whole replacement — read prism_studies_get first; LOCKED once responses exist, the server refuses with `invalid` and the answer is a new study), `adaptiveFollowUps` (AI probes on curious answers), the closing chat (`endChatEnabled` + `endChatFocus`), `completionRedirectUrl` for a BYO panel (null clears), and `autoAnalyzeTarget` (null = manual only). Study ids come from prism_studies_list_workspace. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "publish": {
      "type": "boolean",
      "const": true
    },
    "closed": {
      "type": "boolean"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "questions": {
      "description": "Replacement instrument (drafts only): ordered list of { type, prompt, options?, … } — read prism_studies_get for the shape.",
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "word",
              "text",
              "choice",
              "multi",
              "rank",
              "maxdiff",
              "scale",
              "number",
              "completion"
            ]
          },
          "qid": {
            "type": "string",
            "maxLength": 40
          },
          "showIf": {
            "type": "object",
            "properties": {
              "qid": {
                "type": "string",
                "maxLength": 40
              },
              "anyOf": {
                "maxItems": 20,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200
                }
              },
              "gte": {
                "type": "number"
              },
              "lte": {
                "type": "number"
              }
            },
            "required": [
              "qid"
            ]
          },
          "prompt": {
            "type": "string"
          },
          "prefix": {
            "type": "string"
          },
          "placeholder": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "lowLabel": {
            "type": "string"
          },
          "highLabel": {
            "type": "string"
          },
          "scaleMin": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10
          },
          "scaleMax": {
            "type": "integer",
            "minimum": 2,
            "maximum": 20
          },
          "maxSelections": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "numberMin": {
            "type": "number"
          },
          "numberMax": {
            "type": "number"
          },
          "contextText": {
            "type": "string",
            "maxLength": 2000
          },
          "contextImageUrl": {
            "type": "string",
            "maxLength": 1000
          },
          "loopId": {
            "type": "string",
            "maxLength": 40
          },
          "loopItem": {
            "type": "string",
            "maxLength": 200
          },
          "loopPresentation": {
            "type": "string",
            "enum": [
              "paged",
              "grid"
            ]
          },
          "maxdiffId": {
            "type": "string",
            "maxLength": 40
          },
          "probe": {
            "type": "string",
            "maxLength": 500
          },
          "rotate": {
            "type": "boolean"
          },
          "anchorLast": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5
          },
          "allowOther": {
            "type": "boolean"
          },
          "otherLabel": {
            "type": "string",
            "maxLength": 60
          },
          "exclusiveLast": {
            "type": "boolean"
          },
          "screenOutOptions": {
            "maxItems": 10,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 200
            }
          },
          "loopRotate": {
            "type": "boolean"
          },
          "vwRole": {
            "type": "string",
            "enum": [
              "too_cheap",
              "cheap",
              "expensive",
              "too_expensive"
            ]
          },
          "kanoRole": {
            "type": "string",
            "enum": [
              "functional",
              "dysfunctional"
            ]
          },
          "susIndex": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": {}
      }
    },
    "adaptiveFollowUps": {
      "type": "boolean"
    },
    "endChatEnabled": {
      "type": "boolean"
    },
    "endChatFocus": {
      "description": "What the closing chat should be about; null clears.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "completionRedirectUrl": {
      "description": "http(s) URL respondents land on after submitting ({pid} = participant id); null clears.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "autoAnalyzeTarget": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 2,
          "maximum": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Everything the Results tab shows, as numbers you can trust without counting raw rows: fielding funnel (opens → starts → completes, median completion time, sources, per-question drop-off), per-question aggregates (scale distributions + means + NPS on 0–10, choice/multi counts, rank first-place + mean ranks, MaxDiff set scores, word frequencies, text samples), and quality flags (speeders, duplicate participant ids). ALWAYS use this for quantitative questions about a study — never tally answers yourself.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A cross-study digest: every study with responses — title, origin (standalone / canvas node / tracker wave), response count, latest analysis summary, top themes, and which insights were kept in Ledger. The starting point for 'what have we learned about X?' — follow up with prism_studies_get (insights) or prism_studies_results on the studies that matter.

{
  "type": "object",
  "properties": {
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

An AI research analyst writes the report's narrative layer — executive summary, key findings with their numbers, recommendations — from the study's computed record (funnel, per-question aggregates, themes, quotes). Stored on the study; the printable report at the study page renders it above the charts. Runs against inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Recurring research programs (ADR 0031): name, cadence, enabled state, next wave time, wave count, and the metric + score rule when the series posts readings. Waves themselves are ordinary studies.

{
  "type": "object",
  "properties": {
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CLOSES the current wave (no more responses; it scores and posts to Ledger if bound) and fields the next one from the series' frozen instrument, readying its participant link. Fielding spends credit for follow-ups, closing chats, and analysis, and closing a live wave can't be undone — say both plainly before proposing. Manual launches don't move the schedule clock. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "seriesId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "seriesId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The study's one-on-one qual conversations: guest, status, focus, and — once completed — the structured memo (summary, key claims, tensions, verbatim quotes). Raw transcript included only while no memo exists. inviteUrl is the link to forward for interviews still waiting on their guest.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The stored k-means segmentation over the study's numeric answers: named segments with size, share, and the distinguishing features (segment mean vs overall). Null when none computed yet — prism_studies_segments_compute discovers them (needs 30+ responses and 2+ numeric questions).

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Server-computed banner cut with significance: a target question (scale/number → group means + NPS on 0–10; choice/multi → per-option shares) split by acquisition source or by any single-choice question, each group tested against its complement at 95% (Welch t / two-proportion z). vsRest says higher/lower/not_significant — or not_tested when either side is under the 30-response floor; never present not_tested as 'no difference'. Use this for every 'does X differ by Y?' question instead of eyeballing raw rows.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "targetIndex": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "0-based index of the question to measure."
    },
    "cutBySource": {
      "description": "Cut by acquisition source (?src= tags).",
      "type": "boolean"
    },
    "cutByQuestionIndex": {
      "description": "0-based index of a single-choice question to cut by.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "studyId",
    "targetIndex"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Kicks the theme analysis (incremental — reads only responses and interviews since the last run; the previous themes carry forward). Returns immediately with the run's phase; the run continues server-side, so wait a moment and re-read prism_studies_get — findings are fresh once its insights stop reporting an active run. upToDate: true means there was nothing new (a healthy no-op, not an error). Runs against inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "reanalyzeAll": {
      "description": "Full clean-slate re-read of every response (costlier).",
      "type": "boolean"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a one-on-one AI-led interview on a study and returns the invite link to forward — the guest needs no account. The transcript stays on the study and joins the next analysis run (it never lands in Compass). focusPrompt briefs the interviewer on what to dig into; omitted, it explores the study's territory. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "intervieweeName": {
      "type": "string",
      "maxLength": 120
    },
    "focusPrompt": {
      "type": "string",
      "maxLength": 2000
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Promotes an analysis theme (or, with no themeId, the analysis summary) into the workspace's Ledger as a belief, carrying the supporting verbatims as evidence with links back to the study. THE step that turns a finding into workspace memory — use when the user says an insight matters. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "themeId": {
      "description": "A theme id from prism_studies_get; omit for the summary.",
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Runs k-means over the study's numeric answers (silhouette-picked k) and names the discovered segments from their computed profiles. Needs 30+ responses and 2+ numeric questions; recompute overwrites. Runs naming against inference credit. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Edits a field's name (null reverts to the origin idea), description, or visibility. Nodes are untouched. Field ids come from prism_fields_list. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field id (from prism_fields_list)."
    },
    "name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "visibility": {
      "description": "Who can see it: PRIVATE (only the user), WORKSPACE (every member, the default), or SHARED (specific people, granted afterwards). Say 'make it private' → PRIVATE.",
      "type": "string",
      "enum": [
        "PRIVATE",
        "WORKSPACE",
        "SHARED"
      ]
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior needs_confirmation envelope.",
      "type": "string"
    }
  },
  "required": [
    "fieldId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Removes a field and its whole canvas (soft delete; frees the workspace's field quota). Use when the user is done with an exploration or one was created by mistake — studies attached to its nodes are not deleted. Field ids come from prism_fields_list. May return `needs_confirmation` — name the field and wait.

{
  "type": "object",
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field id (from prism_fields_list)."
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior needs_confirmation envelope.",
      "type": "string"
    }
  },
  "required": [
    "fieldId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

All studies regardless of origin — standalone, canvas-node, and series waves — newest first: title, question count, response count, draft / live / closed state, and the field / node / series it hangs off. The starting point for 'which studies do we have?'; prism_studies_list is the per-node view, prism_research_digest the findings view. Read one with prism_studies_get.

{
  "type": "object",
  "properties": {
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Permanently deletes a study with its responses, interviews, analysis, and share links. Right for a draft that won't be fielded or a duplicate; for a live study the user just wants to stop, prefer prism_studies_update closed: true — that keeps the data. Study ids come from prism_studies_list_workspace. May return `needs_confirmation` — name the study and its response count, then wait.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string",
      "description": "Study id (from prism_studies_list_workspace)."
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior needs_confirmation envelope.",
      "type": "string"
    }
  },
  "required": [
    "studyId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a research program that fields the SAME instrument on a schedule — brand tracking, a weekly pulse — each wave an ordinary study. The questions freeze once the first wave fields (that's the trendline), so get them right with the user first. Optionally bind a Ledger metric + score rule so every wave posts a reading (a `scorer` needs a `metricId`). Waves launch on schedule, or on demand with prism_series_launch_wave. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "questions": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "word",
              "text",
              "choice",
              "multi",
              "rank",
              "maxdiff",
              "scale",
              "number",
              "completion"
            ]
          },
          "qid": {
            "type": "string",
            "maxLength": 40
          },
          "showIf": {
            "type": "object",
            "properties": {
              "qid": {
                "type": "string",
                "maxLength": 40
              },
              "anyOf": {
                "maxItems": 20,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200
                }
              },
              "gte": {
                "type": "number"
              },
              "lte": {
                "type": "number"
              }
            },
            "required": [
              "qid"
            ]
          },
          "prompt": {
            "type": "string"
          },
          "prefix": {
            "type": "string"
          },
          "placeholder": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "lowLabel": {
            "type": "string"
          },
          "highLabel": {
            "type": "string"
          },
          "scaleMin": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10
          },
          "scaleMax": {
            "type": "integer",
            "minimum": 2,
            "maximum": 20
          },
          "maxSelections": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "numberMin": {
            "type": "number"
          },
          "numberMax": {
            "type": "number"
          },
          "contextText": {
            "type": "string",
            "maxLength": 2000
          },
          "contextImageUrl": {
            "type": "string",
            "maxLength": 1000
          },
          "loopId": {
            "type": "string",
            "maxLength": 40
          },
          "loopItem": {
            "type": "string",
            "maxLength": 200
          },
          "loopPresentation": {
            "type": "string",
            "enum": [
              "paged",
              "grid"
            ]
          },
          "maxdiffId": {
            "type": "string",
            "maxLength": 40
          },
          "probe": {
            "type": "string",
            "maxLength": 500
          },
          "rotate": {
            "type": "boolean"
          },
          "anchorLast": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5
          },
          "allowOther": {
            "type": "boolean"
          },
          "otherLabel": {
            "type": "string",
            "maxLength": 60
          },
          "exclusiveLast": {
            "type": "boolean"
          },
          "screenOutOptions": {
            "maxItems": 10,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 200
            }
          },
          "loopRotate": {
            "type": "boolean"
          },
          "vwRole": {
            "type": "string",
            "enum": [
              "too_cheap",
              "cheap",
              "expensive",
              "too_expensive"
            ]
          },
          "kanoRole": {
            "type": "string",
            "enum": [
              "functional",
              "dysfunctional"
            ]
          },
          "susIndex": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": {}
      },
      "description": "The instrument: an ordered list of questions ({ type, prompt, options?, … } — read an existing study with prism_studies_get for the shape)."
    },
    "interval": {
      "type": "string",
      "enum": [
        "daily",
        "weekly"
      ],
      "description": "daily or weekly."
    },
    "scheduleTime": {
      "description": "HH:MM local to scheduleTimezone (default 09:00).",
      "type": "string"
    },
    "scheduleTimezone": {
      "description": "IANA zone (default UTC).",
      "type": "string"
    },
    "dayOfWeek": {
      "description": "Weekly only: 0 = Sunday … 6 = Saturday.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 6
        },
        {
          "type": "null"
        }
      ]
    },
    "adaptiveFollowUps": {
      "description": "AI follow-up questions on curious answers (default true).",
      "type": "boolean"
    },
    "autoAnalyzeTarget": {
      "description": "Analyze each wave automatically at this many completes.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": 2,
          "maximum": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "metricId": {
      "description": "Ledger metric the waves post readings to (from ledger_metrics_list).",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "scorer": {
      "description": "How a wave becomes one number: { kind, questionIndex, option?, minN? }.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "scale_mean",
                "nps",
                "top_2_box",
                "choice_share"
              ]
            },
            "questionIndex": {
              "type": "integer",
              "minimum": 0,
              "maximum": 39
            },
            "option": {
              "type": "string",
              "maxLength": 200
            },
            "minN": {
              "default": 5,
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          },
          "required": [
            "kind",
            "questionIndex"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior needs_confirmation envelope.",
      "type": "string"
    }
  },
  "required": [
    "name",
    "questions",
    "interval"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Edits a series: `enabled: false` pauses the schedule (true resumes), interval / scheduleTime / scheduleTimezone / dayOfWeek move the cadence, name and follow-up / auto-analyze settings change any time. The instrument (questions, scorer) is editable only while no wave has fielded — after that the server refuses with `invalid`, and the answer is a new series. Series ids come from prism_series_list. May return `needs_confirmation`.

{
  "type": "object",
  "properties": {
    "seriesId": {
      "type": "string",
      "description": "Series id (from prism_series_list)."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "enabled": {
      "description": "false pauses, true resumes.",
      "type": "boolean"
    },
    "interval": {
      "type": "string",
      "enum": [
        "daily",
        "weekly"
      ]
    },
    "scheduleTime": {
      "description": "HH:MM.",
      "type": "string"
    },
    "scheduleTimezone": {
      "description": "IANA zone.",
      "type": "string"
    },
    "dayOfWeek": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 6
        },
        {
          "type": "null"
        }
      ]
    },
    "adaptiveFollowUps": {
      "type": "boolean"
    },
    "autoAnalyzeTarget": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 2,
          "maximum": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "questions": {
      "description": "Replacement instrument — only before the first wave fields.",
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "word",
              "text",
              "choice",
              "multi",
              "rank",
              "maxdiff",
              "scale",
              "number",
              "completion"
            ]
          },
          "qid": {
            "type": "string",
            "maxLength": 40
          },
          "showIf": {
            "type": "object",
            "properties": {
              "qid": {
                "type": "string",
                "maxLength": 40
              },
              "anyOf": {
                "maxItems": 20,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200
                }
              },
              "gte": {
                "type": "number"
              },
              "lte": {
                "type": "number"
              }
            },
            "required": [
              "qid"
            ]
          },
          "prompt": {
            "type": "string"
          },
          "prefix": {
            "type": "string"
          },
          "placeholder": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "lowLabel": {
            "type": "string"
          },
          "highLabel": {
            "type": "string"
          },
          "scaleMin": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10
          },
          "scaleMax": {
            "type": "integer",
            "minimum": 2,
            "maximum": 20
          },
          "maxSelections": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "numberMin": {
            "type": "number"
          },
          "numberMax": {
            "type": "number"
          },
          "contextText": {
            "type": "string",
            "maxLength": 2000
          },
          "contextImageUrl": {
            "type": "string",
            "maxLength": 1000
          },
          "loopId": {
            "type": "string",
            "maxLength": 40
          },
          "loopItem": {
            "type": "string",
            "maxLength": 200
          },
          "loopPresentation": {
            "type": "string",
            "enum": [
              "paged",
              "grid"
            ]
          },
          "maxdiffId": {
            "type": "string",
            "maxLength": 40
          },
          "probe": {
            "type": "string",
            "maxLength": 500
          },
          "rotate": {
            "type": "boolean"
          },
          "anchorLast": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5
          },
          "allowOther": {
            "type": "boolean"
          },
          "otherLabel": {
            "type": "string",
            "maxLength": 60
          },
          "exclusiveLast": {
            "type": "boolean"
          },
          "screenOutOptions": {
            "maxItems": 10,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 200
            }
          },
          "loopRotate": {
            "type": "boolean"
          },
          "vwRole": {
            "type": "string",
            "enum": [
              "too_cheap",
              "cheap",
              "expensive",
              "too_expensive"
            ]
          },
          "kanoRole": {
            "type": "string",
            "enum": [
              "functional",
              "dysfunctional"
            ]
          },
          "susIndex": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": {}
      }
    },
    "metricId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "scorer": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "scale_mean",
                "nps",
                "top_2_box",
                "choice_share"
              ]
            },
            "questionIndex": {
              "type": "integer",
              "minimum": 0,
              "maximum": 39
            },
            "option": {
              "type": "string",
              "maxLength": 200
            },
            "minN": {
              "default": 5,
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          },
          "required": [
            "kind",
            "questionIndex"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior needs_confirmation envelope.",
      "type": "string"
    }
  },
  "required": [
    "seriesId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lists the comment threads on one workspace entity (open first, then resolved) with authors and timestamps. Read this before weighing in on contested work — the threads are where disagreement lives before it becomes a decision.

{
  "type": "object",
  "properties": {
    "entityKind": {
      "type": "string",
      "enum": [
        "workbench_flow",
        "compass_page",
        "compass_opportunity",
        "caliper_review",
        "caliper_dataset",
        "caliper_rubric",
        "caliper_eval",
        "caliper_spec",
        "napkin_board",
        "napkin_diagram",
        "napkin_doc",
        "napkin_sheet",
        "napkin_interface",
        "ledger_entry",
        "prism_field",
        "workspace_file"
      ],
      "description": "What the thread hangs on."
    },
    "entityId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "entityKind",
    "entityId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Posts a comment on a workspace entity — a new thread, or a reply when rootId is given. Use it to leave findings where the discussion already lives (an eval result on the flow being debated, a summary on a long thread). Mention people via mentionedUserIds (from workspace member ids) to ring their notification bell; never mention someone who didn't ask to be pulled in.

{
  "type": "object",
  "properties": {
    "entityKind": {
      "type": "string",
      "enum": [
        "workbench_flow",
        "compass_page",
        "compass_opportunity",
        "caliper_review",
        "caliper_dataset",
        "caliper_rubric",
        "caliper_eval",
        "caliper_spec",
        "napkin_board",
        "napkin_diagram",
        "napkin_doc",
        "napkin_sheet",
        "napkin_interface",
        "ledger_entry",
        "prism_field",
        "workspace_file"
      ],
      "description": "What the thread hangs on."
    },
    "entityId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "maxLength": 10000
    },
    "rootId": {
      "description": "Reply into this thread; omit to start a new one.",
      "type": "string"
    },
    "mentionedUserIds": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "entityKind",
    "entityId",
    "body"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sets a comment thread's resolved state (rootId = the thread's root comment id). Resolve ONLY when the human asked or the thread's question is demonstrably settled — and say what settled it in a reply first. Reopening is for new evidence.

{
  "type": "object",
  "properties": {
    "rootId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "resolved": {
      "type": "boolean"
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "type": "string"
    }
  },
  "required": [
    "rootId",
    "resolved"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Finds entities across every tool by name in one call — Workbench flows, Compass pages, Caliper datasets, evals, rubrics, reviews, specs and sources (apps sending agent traces), Ledger entries, Napkin sketches and decks. Use it FIRST when the user names something without saying where it lives ('the onboarding flow', 'that invoice page'); reach for a tool's own list only when you already know the tool. Each hit carries its id, kind, and workspace-relative path, so the id feeds the matching *_get tool and the path makes a link. Results only include what the user can see, and only kinds this token may read.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Case-insensitive substring matched against names/titles."
    },
    "kinds": {
      "description": "Restrict to these kinds (flow, page, dataset, eval, entry, board). Omit to search everything.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "flow",
          "page",
          "dataset",
          "eval",
          "entry",
          "board",
          "file",
          "shim",
          "knowledge_base",
          "task",
          "rubric",
          "review",
          "spec",
          "source"
        ]
      }
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the tags on a batch of entities of one kind — the labels galleries organize by. Ids come from the kind's list/get tool or from search_workspace. Use it before entity_tags_set so you replace the full set knowingly, and to answer 'what is this filed under'. Entities the user can't see are omitted.

{
  "type": "object",
  "properties": {
    "entityKind": {
      "type": "string",
      "enum": [
        "workbench_flow",
        "workbench_task",
        "workbench_kb",
        "compass_page",
        "compass_opportunity",
        "caliper_dataset",
        "caliper_rubric",
        "caliper_eval",
        "caliper_review",
        "caliper_spec",
        "caliper_source",
        "ledger_entry",
        "ledger_metric",
        "napkin_board",
        "napkin_deck",
        "napkin_doc",
        "napkin_sheet",
        "napkin_diagram",
        "prism_field",
        "prism_study"
      ],
      "description": "Which kind the ids belong to."
    },
    "ids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "required": [
    "entityKind",
    "ids"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Without a tag: every tag in use across the workspace with how many entities carry it, most-used first — the vocabulary the team already organizes by. With a tag: everything filed under it across every tool, each with its kind, id, title, and path. Use it to reuse existing labels instead of inventing near-duplicates, and to answer 'show me everything about X' when X is a label.

{
  "type": "object",
  "properties": {
    "tag": {
      "description": "A tag to expand into its items. Omit to list tags.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Replaces the FULL tag set on one entity (an empty list clears it). Read the current tags with entity_tags_get first and pass the merged list — this is not additive. Tags are lowercase letters, numbers, spaces, and hyphens; prefer labels already in use (entity_tags_browse) so the workspace's vocabulary stays small. The id comes from the kind's list/get tool or search_workspace.

{
  "type": "object",
  "properties": {
    "entityKind": {
      "type": "string",
      "enum": [
        "workbench_flow",
        "workbench_task",
        "workbench_kb",
        "compass_page",
        "compass_opportunity",
        "caliper_dataset",
        "caliper_rubric",
        "caliper_eval",
        "caliper_review",
        "caliper_spec",
        "caliper_source",
        "ledger_entry",
        "ledger_metric",
        "napkin_board",
        "napkin_deck",
        "napkin_doc",
        "napkin_sheet",
        "napkin_diagram",
        "prism_field",
        "prism_study"
      ]
    },
    "entityId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40,
        "pattern": "^[a-z0-9](?:[a-z0-9 -]*[a-z0-9])?$"
      }
    },
    "workspace": {
      "description": "Workspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior needs_confirmation response. Omit on the first call.",
      "type": "string"
    }
  },
  "required": [
    "entityKind",
    "entityId",
    "tags"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}