Zindex

Saves a new diagram from a DSP scene or Mermaid text and returns its id, revision 1, content hash and chain hash. key is your stable name for it, unique in the account: repeating a create 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 the account.

Deletes a diagram with all its versions. It can be restored for 24 hours with undo; after that it is gone. Asks the user to confirm.

Changes a saved diagram as a new revision; old revisions are kept. 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 account's diagrams, most recently changed first, with id, key, title and latest revision. query matches the title, key or brief, ignoring case.

Reads a saved diagram by id or key. The default outline is 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' returns 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.

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

Returns SVG and PNG links to a version of a saved diagram, not the image, with its hashes and engine version. A published diagram's links are permanent, with url for its page; others last 7 days. preview adds a PNG for you. 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 when there is one, and a one-line fix.