Zindex

Saves a new diagram from a DSP scene or Mermaid text; returns its id, revision 1 and hashes. key is your stable name for it, unique in the workspace: your repeat with the same key and content returns the existing diagram, not a copy. brief stores context for the next agent. Versions are kept until you delete the diagram or its workspace is deleted.

Deletes a diagram with all its versions. undo restores it within 24 hours; after that it is gone. Asks the user to confirm.

Changes a saved diagram as a new revision; old ones stay. Give baseRevision (the revision you last read), a one-line message, and ops (typed operations, https://zindex.ai/schemas/ops.schema.json), mermaid (the whole diagram edited from view mermaid; only differences apply), restoreRevision (an earlier version back), or brief. An edit with an error saves nothing; one that changes nothing returns noop. requestId makes a retry return the first result. A conflict lists what changed.

Lists this workspace's diagrams, latest version first, each with its family and brief's first line. query matches the title, key or brief, ignoring case; title matches come first.

Reads a diagram. The default outline: a header (id, title, revision, time, hash), the brief, recent versions, one element per line nested by container, and edges as 'id: from -> to'. view 'dsp' returns the scene JSON, 'mermaid' Mermaid to edit and send back to diagram_edit. revision or asOf reads an earlier version; knownRevision, only what changed since; elements, only those elements and their neighbors. Another workspace's diagram answers NOT_FOUND.

Lists a diagram's versions, newest first, with time, who made it (by), client, message, chain hash and counts of elements added, changed and removed. compare (from and to: revision numbers or dates) returns what changed between two versions instead.

SVG and PNG links to a version, not the image, with size, date, hashes, engine. A published diagram's and a version link's links last until revoked, or the diagram made private or deleted (then NOT_FOUND); url is its page. Others, 7 days. A version link needs no sign-in and works from any workspace; a share link gives no title. preview adds a PNG. A page you publish: embed the png file; with no shell, call this with <ref>@<n> on open. scene or mermaid instead of id previews an unsaved diagram.

publish makes a diagram readable by anyone at its link; unpublish makes it private. link makes a share link showing its images, not its scene, to anyone who has it; unlink revokes them all. report sends one version to Zindex support. feedback sends Zindex staff a bug, docs (the docs and engine disagree), request or other; id or snippet attaches a diagram. Asks the user to confirm publish, link, report and feedback.

Checks a DSP scene or Mermaid text without saving it. Returns ok, errors and warnings, each with a code, the element if any, and a one-line fix.