Assumes you have installed an SDK: TypeScript or Python.
format: "artifact": a web page that stores data. This guide covers
creating one, getting its link, reading what people saved in it and keeping the data in each visitor’s browser instead.
Create an artifact
Create it like any document, from aprompt or from your Markdown in content.markdown. It’s priced like any other
create (€0.50 from a sentence at standard).
shared: Doconda stores it, and everyone with the link sees the same records.
Get the link
The page is the document’shtml output. Its link doesn’t expire after 5 minutes like a file’s: it works until the
document’s retention ends (expires_at) or you delete it.
Read the saved data
documents.data(id) lists the page’s collections and how many records each has. documents.data(id, collection)
returns that collection’s records, the 1,000 most recently updated at most.
window.doconda.db; see save data from the page.
data on a document that isn’t an artifact fails with 409 not_an_artifact.
Keep the data in the browser
Withartifact: { storage: "local" }, each visitor’s data stays in their own browser and never reaches Doconda.
datacan’t read alocalartifact: it fails with409 artifact_is_local.- With
retention: "none",localis the only mode and Doconda doesn’t host the page: download it withdocuments.download(id, "html")within 15 minutes. artifactis only accepted withformat: "artifact"; otherwise the request fails with422 input_invalid.documents.delete(id)removes the page and all its data.
Next steps
Artifacts guide
How the page stores data, and its limits.
Retention
How long the page and its data last.
SDK reference
Every method and what it returns.