[{"data":1,"prerenderedAt":879},["ShallowReactive",2],{"navigation_docs":3,"-rest-errors":194,"-rest-errors-surround":874},[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":121,"body":196,"description":868,"extension":869,"links":870,"meta":871,"navigation":770,"path":122,"seo":872,"stem":123,"__hash__":873},"docs/3.rest/9.errors.md",{"type":197,"value":198,"toc":859},"minimark",[199,203,224,229,389,462,474,478,483,594,598,730,734,744,820,824,855],[200,201,121],"h1",{"id":202},"errors",[204,205,207,208,212,213,215,216,219,220,223],"callout",{"type":206},"info","Every error response — REST or MCP — carries the same ",[209,210,211],"code",{},"{ ok: false, errors: [...] }"," shape. ",[209,214,209],{}," is stable; ",[209,217,218],{},"message"," and ",[209,221,222],{},"fix_hint"," are human-readable.",[225,226,228],"h2",{"id":227},"shape","Shape",[230,231,236],"pre",{"className":232,"code":233,"language":234,"meta":235,"style":235},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"ok\": false,\n  \"errors\": [\n    {\n      \"code\": \"element_not_found\",\n      \"message\": \"Element 'missing' not found in ai@2026-04-16-beta.\",\n      \"path\": \"elements[0].element_id\",\n      \"fix_hint\": \"Use GET /api/v2/schemas/:version/elements to enumerate available element ids.\"\n    }\n  ]\n}\n","json","",[209,237,238,247,266,280,286,311,331,352,371,377,383],{"__ignoreMap":235},[239,240,243],"span",{"class":241,"line":242},"line",1,[239,244,246],{"class":245},"sMK4o","{\n",[239,248,250,253,257,260,263],{"class":241,"line":249},2,[239,251,252],{"class":245},"  \"",[239,254,256],{"class":255},"spNyl","ok",[239,258,259],{"class":245},"\"",[239,261,262],{"class":245},":",[239,264,265],{"class":245}," false,\n",[239,267,269,271,273,275,277],{"class":241,"line":268},3,[239,270,252],{"class":245},[239,272,202],{"class":255},[239,274,259],{"class":245},[239,276,262],{"class":245},[239,278,279],{"class":245}," [\n",[239,281,283],{"class":241,"line":282},4,[239,284,285],{"class":245},"    {\n",[239,287,289,292,295,297,299,302,306,308],{"class":241,"line":288},5,[239,290,291],{"class":245},"      \"",[239,293,209],{"class":294},"sBMFI",[239,296,259],{"class":245},[239,298,262],{"class":245},[239,300,301],{"class":245}," \"",[239,303,305],{"class":304},"sfazB","element_not_found",[239,307,259],{"class":245},[239,309,310],{"class":245},",\n",[239,312,314,316,318,320,322,324,327,329],{"class":241,"line":313},6,[239,315,291],{"class":245},[239,317,218],{"class":294},[239,319,259],{"class":245},[239,321,262],{"class":245},[239,323,301],{"class":245},[239,325,326],{"class":304},"Element 'missing' not found in ai@2026-04-16-beta.",[239,328,259],{"class":245},[239,330,310],{"class":245},[239,332,334,336,339,341,343,345,348,350],{"class":241,"line":333},7,[239,335,291],{"class":245},[239,337,338],{"class":294},"path",[239,340,259],{"class":245},[239,342,262],{"class":245},[239,344,301],{"class":245},[239,346,347],{"class":304},"elements[0].element_id",[239,349,259],{"class":245},[239,351,310],{"class":245},[239,353,355,357,359,361,363,365,368],{"class":241,"line":354},8,[239,356,291],{"class":245},[239,358,222],{"class":294},[239,360,259],{"class":245},[239,362,262],{"class":245},[239,364,301],{"class":245},[239,366,367],{"class":304},"Use GET /api/v2/schemas/:version/elements to enumerate available element ids.",[239,369,370],{"class":245},"\"\n",[239,372,374],{"class":241,"line":373},9,[239,375,376],{"class":245},"    }\n",[239,378,380],{"class":241,"line":379},10,[239,381,382],{"class":245},"  ]\n",[239,384,386],{"class":241,"line":385},11,[239,387,388],{"class":245},"}\n",[390,391,392,408],"table",{},[393,394,395],"thead",{},[396,397,398,402,405],"tr",{},[399,400,401],"th",{},"Field",[399,403,404],{},"Required",[399,406,407],{},"Meaning",[409,410,411,424,435,451],"tbody",{},[396,412,413,418,421],{},[414,415,416],"td",{},[209,417,209],{},[414,419,420],{},"yes",[414,422,423],{},"Stable machine-readable code from the table below.",[396,425,426,430,432],{},[414,427,428],{},[209,429,218],{},[414,431,420],{},[414,433,434],{},"Human-readable diagnostic.",[396,436,437,441,444],{},[414,438,439],{},[209,440,338],{},[414,442,443],{},"no",[414,445,446,447,450],{},"JSON path into the caller's payload (e.g. ",[209,448,449],{},"elements[3].category_id",").",[396,452,453,457,459],{},[414,454,455],{},[209,456,222],{},[414,458,443],{},[414,460,461],{},"Short actionable instruction.",[463,464,465,466,468,469,473],"p",{},"Adding new ",[209,467,209],{}," values is ",[470,471,472],"strong",{},"additive","; renaming or removing is a breaking change (guarded by snapshot fixtures in the repo).",[225,475,477],{"id":476},"codes","Codes",[479,480,482],"h3",{"id":481},"transport-level-http-status-mirrors-the-code","Transport-level (HTTP status mirrors the code)",[390,484,485,497],{},[393,486,487],{},[396,488,489,492,495],{},[399,490,491],{},"Code",[399,493,494],{},"HTTP",[399,496,407],{},[409,498,499,512,525,538,555,568,581],{},[396,500,501,506,509],{},[414,502,503],{},[209,504,505],{},"bad_request",[414,507,508],{},"400",[414,510,511],{},"Malformed input — version path param, query params, request body, or invalid cursor.",[396,513,514,519,522],{},[414,515,516],{},[209,517,518],{},"not_found",[414,520,521],{},"404",[414,523,524],{},"Unknown version, element, symbol, variant, or shape.",[396,526,527,532,535],{},[414,528,529],{},[209,530,531],{},"payload_too_large",[414,533,534],{},"413",[414,536,537],{},"Request body exceeds the configured byte limit.",[396,539,540,545,548],{},[414,541,542],{},[209,543,544],{},"rate_limited",[414,546,547],{},"429",[414,549,550,551,554],{},"Client exceeded the rate-limit bucket. ",[209,552,553],{},"Retry-After"," header indicates the wait.",[396,556,557,562,565],{},[414,558,559],{},[209,560,561],{},"timeout",[414,563,564],{},"504",[414,566,567],{},"Request exceeded the per-route wall-clock budget.",[396,569,570,575,578],{},[414,571,572],{},[209,573,574],{},"upstream_error",[414,576,577],{},"502",[414,579,580],{},"Schema-store (R2) read failed.",[396,582,583,588,591],{},[414,584,585],{},[209,586,587],{},"internal_error",[414,589,590],{},"500",[414,592,593],{},"Unexpected server error.",[479,595,597],{"id":596},"semantic-surfaced-in-200-bodies","Semantic — surfaced in 200 bodies",[390,599,600,611],{},[393,601,602],{},[396,603,604,606,609],{},[399,605,491],{},[399,607,608],{},"Raised by",[399,610,407],{},[409,612,613,632,652,666,679,700,712],{},[396,614,615,620,626],{},[414,616,617],{},[209,618,619],{},"parse_error",[414,621,622,625],{},[209,623,624],{},"POST /validate",", MCP validate / render",[414,627,628,629,631],{},"Datachain shape failed Zod validation. ",[209,630,338],{}," locates the offending field.",[396,633,634,638,649],{},[414,635,636],{},[209,637,305],{},[414,639,640,641,643,644,646,647],{},"MCP ",[209,642,67],{}," (per-id), MCP ",[209,645,79],{},", MCP ",[209,648,63],{},[414,650,651],{},"Element not present in the version.",[396,653,654,659,663],{},[414,655,656],{},[209,657,658],{},"element_ids_too_many",[414,660,640,661],{},[209,662,67],{},[414,664,665],{},">100 unique ids after dedupe.",[396,667,668,673,676],{},[414,669,670],{},[209,671,672],{},"unknown_version",[414,674,675],{},"MCP tools",[414,677,678],{},"Manifest missing for the resolved version.",[396,680,681,686,690],{},[414,682,683],{},[209,684,685],{},"unknown_variant",[414,687,640,688],{},[209,689,79],{},[414,691,692,693,696,697,699],{},"Variant not in the element's ",[209,694,695],{},"icon_variants",". ",[209,698,222],{}," lists valid variants.",[396,701,702,707,709],{},[414,703,704],{},[209,705,706],{},"invalid_arguments",[414,708,675],{},[414,710,711],{},"Argument failed the tool's Zod input schema.",[396,713,714,717,727],{},[414,715,716],{},"Semantic validator codes",[414,718,719,722,723,722,725],{},[209,720,721],{},"/validate",", ",[209,724,75],{},[209,726,71],{},[414,728,729],{},"Shape-valid but semantically wrong — required categories missing, placement invalid, cardinality violated, etc.",[225,731,733],{"id":732},"rate-limiting","Rate limiting",[463,735,736,737,739,740,743],{},"Read endpoints share one bucket; ",[209,738,624],{}," uses a dedicated tighter bucket. Setting ",[209,741,742],{},"DTPR-Client: \u003Cname>"," opts your traffic into a per-client bucket. On exceed:",[230,745,749],{"className":746,"code":747,"language":748,"meta":235,"style":235},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","HTTP/1.1 429 Too Many Requests\nContent-Type: application/json\nRetry-After: 60\n\n{\n  \"ok\": false,\n  \"errors\": [\n    {\n      \"code\": \"rate_limited\",\n      \"message\": \"Rate limit exceeded.\",\n      \"fix_hint\": \"Wait 60 seconds or set `DTPR-Client` for a dedicated bucket.\"\n    }\n  ]\n}\n","http",[209,750,751,756,761,766,772,776,781,786,790,795,800,805,810,815],{"__ignoreMap":235},[239,752,753],{"class":241,"line":242},[239,754,755],{},"HTTP/1.1 429 Too Many Requests\n",[239,757,758],{"class":241,"line":249},[239,759,760],{},"Content-Type: application/json\n",[239,762,763],{"class":241,"line":268},[239,764,765],{},"Retry-After: 60\n",[239,767,768],{"class":241,"line":282},[239,769,771],{"emptyLinePlaceholder":770},true,"\n",[239,773,774],{"class":241,"line":288},[239,775,246],{},[239,777,778],{"class":241,"line":313},[239,779,780],{},"  \"ok\": false,\n",[239,782,783],{"class":241,"line":333},[239,784,785],{},"  \"errors\": [\n",[239,787,788],{"class":241,"line":354},[239,789,285],{},[239,791,792],{"class":241,"line":373},[239,793,794],{},"      \"code\": \"rate_limited\",\n",[239,796,797],{"class":241,"line":379},[239,798,799],{},"      \"message\": \"Rate limit exceeded.\",\n",[239,801,802],{"class":241,"line":385},[239,803,804],{},"      \"fix_hint\": \"Wait 60 seconds or set `DTPR-Client` for a dedicated bucket.\"\n",[239,806,808],{"class":241,"line":807},12,[239,809,376],{},[239,811,813],{"class":241,"line":812},13,[239,814,382],{},[239,816,818],{"class":241,"line":817},14,[239,819,388],{},[225,821,823],{"id":822},"see-also","See also",[825,826,827,842,849],"ul",{},[828,829,830],"li",{},[831,832,833,834,836,837,836,839],"a",{"href":34},"MCP envelope — ",[209,835,256],{},"/",[209,838,202],{},[209,840,841],{},"meta",[828,843,844,848],{},[831,845,846],{"href":110},[209,847,109],{}," — semantic validator errors.",[828,850,851],{},[831,852,640,853],{"href":72},[209,854,71],{},[856,857,858],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":235,"searchDepth":249,"depth":249,"links":860},[861,862,866,867],{"id":227,"depth":249,"text":228},{"id":476,"depth":249,"text":477,"children":863},[864,865],{"id":481,"depth":268,"text":482},{"id":596,"depth":268,"text":597},{"id":732,"depth":249,"text":733},{"id":822,"depth":249,"text":823},"The shared error shape and canonical code list.","md",null,{},{"title":121,"description":868},"1FWkzbDk2W4PMwF3BMm52td3p8Hjy4un2vUN4z0OdjM",[875,877],{"title":117,"path":118,"stem":119,"description":876,"children":-1},"Cursor semantics, limits, field projection, and locale filtering.",{"title":125,"path":126,"stem":127,"description":878,"children":-1},"Shape × symbol × variant mental model behind every DTPR icon.",1776525922452]