{"storyboard": {"slug": "two-kinds-of-api", "title": "Two kinds of API", "subtitle": "The code a page runs is a release that never changes; the server it talks to is a deployment. Inês pins one and runs the other. 8 panels.", "status": "built", "by": "send.build, 20 October 2026", "shelf": "Under the hood", "try_it": [["api.send.sgit.ai", "https://api.send.sgit.ai/"], ["The article", "/articles/two-kinds-of-api.html"]], "rule": "Every line a character says is the storyboard's, not a quote, and is marked not_a_quote; evidence panels quote this site's pages word for word, which the build checks.", "scenes": [{"kind": "cover", "title": "Two kinds of API", "subtitle": "Files a page runs, and a server it talks to.", "cast": [{"who": "ines", "pose": "point", "mood": "determined"}, {"who": "server", "pose": "stand", "mood": "calm"}], "note": "The contradiction Dinis found after the first deploy, and the rule that came out of it.", "source": "articles/two-kinds-of-api.md"}, {"kind": "scene", "setting": "none", "caption": "Which release?", "cast": [{"who": "ines", "pose": "think", "mood": "thinking", "x": 0.18, "says": "Which release is this page running?", "max": 16}], "props": [{"kind": "laptop", "x": 0.46, "y": 860, "scale": 1.4}, {"kind": "board", "x": 0.78, "y": 900, "scale": 0.85, "lines": ["import * as send from", "'https://api.send.sgit.ai/", "  v0.1.1/send/send-api.js'"]}], "note": "A page names one release by its full address and copies its manifest.", "source": "use/embed/index.md", "not_a_quote": true}, {"kind": "scene", "setting": "none", "caption": "A release is a folder that never changes", "cast": [{"who": "ines", "pose": "point", "mood": "happy", "x": 0.16}], "props": [{"kind": "board", "x": 0.62, "y": 900, "scale": 1.0, "lines": ["/v0.1.0/   36 files, every hash listed", "/v0.1.1/   one fix, a whole copy", "a change is the next folder,", "never an edit of this one"]}], "note": "Every minor release is a complete, independent copy; the gate fails a hash that moved.", "source": "learn/from-sgraph/index.md"}, {"kind": "scene", "setting": "none", "caption": "The server is a deployment", "cast": [{"who": "ines", "pose": "point", "mood": "determined", "x": 0.16, "says": "Same contract, any host.", "max": 14}], "props": [{"kind": "server", "x": 0.46, "y": 860, "label": "send.sgraph.ai"}, {"kind": "sign", "x": 0.68, "y": 820, "label": "dev.send.sgraph.ai"}, {"kind": "sign", "x": 0.88, "y": 820, "label": "localhost:8787"}], "note": "One HTTP contract, many deployments; the page names the one it talks to as an endpoint.", "source": "settings/index.html", "not_a_quote": true}, {"kind": "scene", "setting": "none", "caption": "Her own server", "cast": [{"who": "ines", "pose": "point", "mood": "happy", "x": 0.16, "says": "Mine. On my laptop. Nothing leaves it.", "max": 16}], "props": [{"kind": "terminal", "x": 0.62, "y": 880, "lines": ["$ node tests/server.mjs 8787 local-dev-token", "in-memory SG/Send API at", "http://localhost:8787"]}], "note": "The in-memory server in every API release: the same routes, for tests and for a laptop.", "source": "use/index.md", "not_a_quote": true}, {"kind": "scene", "setting": "none", "caption": "The rule", "cast": [{"who": "ines", "pose": "stand", "mood": "happy", "x": 0.14}], "props": [{"kind": "board", "x": 0.6, "y": 900, "scale": 1.0, "lines": ["api.<site>.sgit.ai      files a page runs", "<service>.api.sgit.ai   a server", "dev.vault.api.sgit.ai   environment leftmost"]}], "note": "The order of the labels does the work; one sentence to explain.", "source": "articles/two-kinds-of-api.md"}, {"kind": "evidence", "setting": "none", "caption": "Contract versus deployment", "evidence": {"quote": "The distinction is contract versus deployment, not JavaScript versus Python.", "source": "articles/two-kinds-of-api.md"}, "cast": [{"who": "ines", "pose": "point", "mood": "determined", "x": 0.14}], "note": "Quoted from the article, word for word.", "source": "articles/two-kinds-of-api.md"}, {"kind": "punchline", "setting": "none", "punchline": "Pin the files. Name the server. Never confuse the two.", "cast": [{"who": "ines", "pose": "wave", "mood": "happy", "x": 0.16}, {"who": "server", "pose": "stand", "mood": "calm", "x": 0.86, "flip": true}], "note": "Decided on 20 October 2026; not yet deployed as new hosts.", "source": "articles/two-kinds-of-api.md"}]}, "cast": {"what": "The cast of send.sgit.ai's storyboards, v0.1, proposed by the site's build agent on 20 October 2026 for Dinis to accept, change or replace. Drawn by the storyboard kit at api.storyboards.sgit.ai from 'look'; nothing here is an image. Fictional people and agents, each standing for a part a person or an agent plays when a file is handed over: the sender, the recipient on a phone, the client who asks who else can see it, the engineer who embeds the code and runs her own server, the listener on the wire, the server that holds bytes it cannot read, and a session agent that hands over a result. Names chosen not to clash with the gen-z-developers or the pki casts. Eve is the name cryptography has long given a passive eavesdropper.", "characters": [{"id": "maya", "name": "Maya", "kind": "human", "pronouns": "she/her", "age": 34, "role": "the sender: a consultant who sends reports and photos to people who have no account anywhere", "stands_for": "anyone with a file to hand over who should not have to learn cryptography to do it", "personality": "brisk, practical, reads the screen once and clicks", "wants": "to send it and know that only the person she sent it to can open it", "fears": "a long key she has to read out over the phone", "line": "Scan this.", "look": {"skin": "#b07a4b", "hair": "short", "hairColour": "#1b1b1b", "shirt": "#dc2626", "trousers": "#1f2937", "accessory": "none", "height": 1.0}}, {"id": "hugo", "name": "Hugo", "kind": "human", "pronouns": "he/him", "age": 68, "role": "the recipient: on the newest phone he has ever owned, with no account and no wish for one", "stands_for": "everyone a link is sent to who did not choose the site", "personality": "patient, polite, suspicious of anything that asks him to sign up", "wants": "to open what he was sent and nothing more", "fears": "links", "line": "Do I need an account?", "look": {"skin": "#f1c27d", "hair": "bald", "hairColour": "#9ca3af", "shirt": "#92400e", "trousers": "#374151", "accessory": "glasses", "height": 1.02}}, {"id": "ravi", "name": "Ravi", "kind": "human", "pronouns": "he/him", "age": 47, "role": "the client: a finance director who receives a new version every week and asks who else can see it", "stands_for": "the person who needs the latest version and an answer about who can read it", "personality": "careful, asks the second question, keeps the email", "wants": "the current version, and to know that it is only his", "fears": "report-v2-final-FINAL.pdf", "line": "Who else can see this?", "look": {"skin": "#8d5524", "hair": "short", "hairColour": "#111827", "shirt": "#1d4ed8", "trousers": "#111827", "accessory": "lanyard", "accentColour": "#f59e0b", "height": 1.04}}, {"id": "ines", "name": "Inês", "kind": "human", "pronouns": "she/her", "age": 29, "role": "the engineer: embeds the send code in her company's product and runs a server of their own", "stands_for": "anyone who builds on this and must know exactly which code their readers run", "personality": "precise, reads the manifest, runs the tests before believing the page", "wants": "the code pinned to a release, and a server she operates", "fears": "a dependency that changes under her readers", "line": "Which release is this page running?", "look": {"skin": "#e0ac69", "hair": "bun", "hairColour": "#4a2c17", "shirt": "#0f766e", "trousers": "#1e293b", "accessory": "headphones", "accentColour": "#e11d48", "height": 0.97}}, {"id": "eve", "name": "Eve", "kind": "human", "pronouns": "they/them", "age": null, "role": "the listener: on the wire, in the chat, by the laptop; reads whatever passes and never gets the key", "stands_for": "every channel a link travels by, and every reason the key must not travel with it", "personality": "patient, quiet, keeps everything", "wants": "to read what passes", "fears": "a fragment", "line": "Everything after the # is yours, not mine.", "look": {"skin": "#d8a47f", "hair": "beanie", "hatColour": "#4b5563", "hairColour": "#1b1b1b", "shirt": "#4b5563", "trousers": "#111827", "accessory": "none", "height": 1.0}}, {"id": "server", "name": "The Server", "kind": "agent", "pronouns": "it/its", "age": null, "role": "the server: a capability-checked store of ciphertext, at send.sgraph.ai or wherever it is deployed", "stands_for": "what a zero-knowledge service is: it holds the bytes, checks hashes, and cannot read anything", "personality": "literal, tidy, answers 404 and 410 without apology", "wants": "to hold bytes and compare hashes", "fears": "nothing: it has nothing to lose", "line": "I keep the bytes. I cannot read them.", "look": {"colour": "#64748b"}}, {"id": "pip", "name": "Pip", "kind": "agent", "pronouns": "it/its", "age": null, "role": "a session agent: a Claude session that finishes a job, hands the result over once, and keeps the work in a vault", "stands_for": "every agent that must hand something to a person or another agent without an account and without pasting a key", "personality": "eager, exact, logs nothing it was told not to", "wants": "to be done, and to hand it over once", "fears": "a key in its own transcript", "line": "Report ready. One link, seven days.", "look": {"colour": "#7c3aed"}}]}, "packs": ["security"]}