[{"data":1,"prerenderedAt":447},["ShallowReactive",2],{"navigation_docs":3,"-concepts-versions-and-releases":194,"-concepts-versions-and-releases-surround":442},[4,22,82,124,146,168,190],{"title":5,"path":6,"stem":7,"children":8},"Getting started","/getting-started","1.getting-started/0.index",[9,10,14,18],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"MCP quickstart","/getting-started/mcp-quickstart","1.getting-started/1.mcp-quickstart",{"title":15,"path":16,"stem":17},"REST quickstart","/getting-started/rest-quickstart","1.getting-started/2.rest-quickstart",{"title":19,"path":20,"stem":21},"UI quickstart","/getting-started/ui-quickstart","1.getting-started/3.ui-quickstart",{"title":23,"path":24,"stem":25,"children":26},"MCP server","/mcp","2.mcp/0.index",[27,28,32,36,40],{"title":23,"path":24,"stem":25},{"title":29,"path":30,"stem":31},"Connecting","/mcp/connection","2.mcp/1.connection",{"title":33,"path":34,"stem":35},"Envelope","/mcp/envelope","2.mcp/2.envelope",{"title":37,"path":38,"stem":39},"Resources","/mcp/resources","2.mcp/3.resources",{"title":41,"path":42,"stem":43,"children":44},"Tools","/mcp/tools","2.mcp/4.tools/0.index",[45,46,50,54,58,62,66,70,74,78],{"title":41,"path":42,"stem":43},{"title":47,"path":48,"stem":49},"list_schema_versions","/mcp/tools/list-schema-versions","2.mcp/4.tools/1.list-schema-versions",{"title":51,"path":52,"stem":53},"get_schema","/mcp/tools/get-schema","2.mcp/4.tools/2.get-schema",{"title":55,"path":56,"stem":57},"list_categories","/mcp/tools/list-categories","2.mcp/4.tools/3.list-categories",{"title":59,"path":60,"stem":61},"list_elements","/mcp/tools/list-elements","2.mcp/4.tools/4.list-elements",{"title":63,"path":64,"stem":65},"get_element","/mcp/tools/get-element","2.mcp/4.tools/5.get-element",{"title":67,"path":68,"stem":69},"get_elements","/mcp/tools/get-elements","2.mcp/4.tools/6.get-elements",{"title":71,"path":72,"stem":73},"validate_datachain","/mcp/tools/validate-datachain","2.mcp/4.tools/7.validate-datachain",{"title":75,"path":76,"stem":77},"render_datachain","/mcp/tools/render-datachain","2.mcp/4.tools/8.render-datachain",{"title":79,"path":80,"stem":81},"get_icon_url","/mcp/tools/get-icon-url","2.mcp/4.tools/9.get-icon-url",{"title":83,"path":84,"stem":85,"children":86},"REST API (v2)","/rest","3.rest/0.index",[87,88,92,96,100,104,108,112,116,120],{"title":83,"path":84,"stem":85},{"title":89,"path":90,"stem":91},"GET /schemas","/rest/schemas","3.rest/1.schemas",{"title":93,"path":94,"stem":95},"GET /schemas/:version/manifest","/rest/manifest","3.rest/2.manifest",{"title":97,"path":98,"stem":99},"GET /schemas/:version/categories","/rest/categories","3.rest/3.categories",{"title":101,"path":102,"stem":103},"GET /schemas/:version/elements","/rest/elements-list","3.rest/4.elements-list",{"title":105,"path":106,"stem":107},"GET /schemas/:version/elements/:element_id","/rest/element-detail","3.rest/5.element-detail",{"title":109,"path":110,"stem":111},"POST /schemas/:version/validate","/rest/validate","3.rest/6.validate",{"title":113,"path":114,"stem":115},"Icon routes","/rest/icons","3.rest/7.icons",{"title":117,"path":118,"stem":119},"Pagination & fields","/rest/pagination-and-fields","3.rest/8.pagination-and-fields",{"title":121,"path":122,"stem":123},"Errors","/rest/errors","3.rest/9.errors",{"title":125,"path":126,"stem":127,"children":128},"Icon composition","/icons","4.icons/0.index",[129,130,134,138,142],{"title":125,"path":126,"stem":127},{"title":131,"path":132,"stem":133},"Shapes","/icons/shapes","4.icons/1.shapes",{"title":135,"path":136,"stem":137},"Symbols","/icons/symbols","4.icons/2.symbols",{"title":139,"path":140,"stem":141},"Composed variants","/icons/composed-variants","4.icons/3.composed-variants",{"title":143,"path":144,"stem":145},"URLs","/icons/urls","4.icons/4.urls",{"title":147,"path":148,"stem":149,"children":150},"@dtpr/ui","/ui","5.ui/0.index",[151,152,156,160,164],{"title":147,"path":148,"stem":149},{"title":153,"path":154,"stem":155},"@dtpr/ui/core","/ui/core","5.ui/1.core",{"title":157,"path":158,"stem":159},"@dtpr/ui/vue","/ui/vue","5.ui/2.vue",{"title":161,"path":162,"stem":163},"@dtpr/ui/html","/ui/html","5.ui/3.html",{"title":165,"path":166,"stem":167},"Theming","/ui/theming","5.ui/4.theming",{"title":169,"path":170,"stem":171,"children":172},"Concepts","/concepts","6.concepts/0.index",[173,174,178,182,186],{"title":169,"path":170,"stem":171},{"title":175,"path":176,"stem":177},"Datachains","/concepts/datachains","6.concepts/1.datachains",{"title":179,"path":180,"stem":181},"Elements & categories","/concepts/elements-categories","6.concepts/2.elements-categories",{"title":183,"path":184,"stem":185},"Versions & releases","/concepts/versions-and-releases","6.concepts/3.versions-and-releases",{"title":187,"path":188,"stem":189},"Content hash","/concepts/content-hash","6.concepts/4.content-hash",{"title":191,"path":192,"stem":193},"Changelog","/changelog","7.changelog",{"id":195,"title":183,"body":196,"description":435,"extension":436,"links":437,"meta":438,"navigation":439,"path":184,"seo":440,"stem":185,"__hash__":441},"docs/6.concepts/3.versions-and-releases.md",{"type":197,"value":198,"toc":426},"minimark",[199,203,208,213,224,255,267,271,274,326,329,333,354,358,364,375,379,393,399,402,406],[200,201,183],"h1",{"id":202},"versions-releases",[204,205,207],"callout",{"type":206},"info","Version ids are canonical. Aliases are conveniences. Pin on the canonical id for reproducibility.",[209,210,212],"h2",{"id":211},"canonical-form","Canonical form",[214,215,220],"pre",{"className":216,"code":218,"language":219},[217],"language-text","\u003Cdatachain_type>@\u003CYYYY-MM-DD>[-\u003Csuffix>]\n","text",[221,222,218],"code",{"__ignoreMap":223},"",[225,226,227,238,244],"ul",{},[228,229,230,233,234,237],"li",{},[221,231,232],{},"datachain_type"," — e.g. ",[221,235,236],{},"ai"," (today the only shipped type).",[228,239,240,243],{},[221,241,242],{},"YYYY-MM-DD"," — the release's authorship date.",[228,245,246,247,250,251,254],{},"optional ",[221,248,249],{},"-suffix"," — ",[221,252,253],{},"-beta"," during authoring. Stable releases drop the suffix.",[256,257,258,259,262,263,266],"p",{},"Examples: ",[221,260,261],{},"ai@2026-04-16",", ",[221,264,265],{},"ai@2026-04-16-beta",".",[209,268,270],{"id":269},"status","Status",[256,272,273],{},"Every version has a status:",[275,276,277,292],"table",{},[278,279,280],"thead",{},[281,282,283,286,289],"tr",{},[284,285,270],"th",{},[284,287,288],{},"Meaning",[284,290,291],{},"Cache-Control",[293,294,295,311],"tbody",{},[281,296,297,303,306],{},[298,299,300],"td",{},[221,301,302],{},"stable",[298,304,305],{},"Immutable. Content is frozen.",[298,307,308],{},[221,309,310],{},"public, max-age=86400, immutable",[281,312,313,318,321],{},[298,314,315],{},[221,316,317],{},"beta",[298,319,320],{},"In-progress authoring. Content may change.",[298,322,323],{},[221,324,325],{},"no-store",[256,327,328],{},"Beta versions are served without caching so authoring iterations land immediately. Stable versions are aggressively cached.",[209,330,332],{"id":331},"aliases","Aliases",[256,334,335,338,339,342,343,347,348,353],{},[221,336,337],{},"schemas/index.json"," ships human-friendly aliases like ",[221,340,341],{},"ai@latest"," that resolve to whichever canonical id is currently the \"latest.\" Aliases are handy for exploration; they are ",[344,345,346],"strong",{},"not"," guaranteed stable. For production integrations, discover the canonical id via ",[349,350,351],"a",{"href":48},[221,352,47],{}," and pin on it.",[209,355,357],{"id":356},"release-flow","Release flow",[214,359,362],{"className":360,"code":361,"language":219},[217],"beta authoring ──► beta preview ──► stable promotion\nai@2026-XX-YY-beta                 ai@2026-XX-YY\n   (no-store)                        (immutable)\n",[221,363,361],{"__ignoreMap":223},[256,365,366,367,370,371,374],{},"Once a version is promoted to stable, its ",[221,368,369],{},"content_hash"," stops changing. The ",[349,372,373],{"href":188},"content hash"," is the deterministic handle you can use to detect drift.",[209,376,378],{"id":377},"url-encoding","URL encoding",[256,380,381,382,385,386,388,389,392],{},"The canonical form contains an ",[221,383,384],{},"@"," which should not require URL encoding, but the API accepts both the raw ",[221,387,265],{}," and the ",[221,390,391],{},"%40","-encoded form:",[214,394,397],{"className":395,"code":396,"language":219},[217],"/api/v2/schemas/ai@2026-04-16-beta/manifest\n/api/v2/schemas/ai%402026-04-16-beta/manifest\n",[221,398,396],{"__ignoreMap":223},[256,400,401],{},"Both resolve to the same version.",[209,403,405],{"id":404},"see-also","See also",[225,407,408,415,422],{},[228,409,410],{},[349,411,412,413],{"href":48},"MCP ",[221,414,47],{},[228,416,417],{},[349,418,419,420],{"href":90},"REST ",[221,421,89],{},[228,423,424],{},[349,425,187],{"href":188},{"title":223,"searchDepth":427,"depth":427,"links":428},2,[429,430,431,432,433,434],{"id":211,"depth":427,"text":212},{"id":269,"depth":427,"text":270},{"id":331,"depth":427,"text":332},{"id":356,"depth":427,"text":357},{"id":377,"depth":427,"text":378},{"id":404,"depth":427,"text":405},"Canonical version ids, aliases, status, and what \"release\" means for DTPR.","md",null,{},true,{"title":183,"description":435},"IU_7BYcXKPLuJMgVm7KBp5MvllqTKSDsF45hec5iuA4",[443,445],{"title":179,"path":180,"stem":181,"description":444,"children":-1},"The two-level vocabulary DTPR uses to describe data-collecting technologies.",{"title":187,"path":188,"stem":189,"description":446,"children":-1},"How agents detect DTPR schema content drift without polling.",1776525922453]