[{"data":1,"prerenderedAt":979},["ShallowReactive",2],{"navigation_docs_en":3,"dtpr-schemas-index":287,"-en-rest-errors":295,"-en-rest-errors-surround":974},[4,22,26,30,102,152,174,196,226,278,283],{"title":5,"path":6,"stem":7,"children":8},"Getting started","/en/getting-started","en/1.getting-started/0.index",[9,10,14,18],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"MCP quickstart","/en/getting-started/mcp-quickstart","en/1.getting-started/1.mcp-quickstart",{"title":15,"path":16,"stem":17},"REST quickstart","/en/getting-started/rest-quickstart","en/1.getting-started/2.rest-quickstart",{"title":19,"path":20,"stem":21},"UI quickstart","/en/getting-started/ui-quickstart","en/1.getting-started/3.ui-quickstart",{"title":23,"path":24,"stem":25},"Attribution","/en/attribution","en/10.attribution",{"title":27,"path":28,"stem":29},"Cite DTPR for AI","/en/cite","en/11.cite",{"title":31,"path":32,"stem":33,"children":34},"MCP server","/en/mcp","en/2.mcp/0.index",[35,36,40,44,48,98],{"title":31,"path":32,"stem":33},{"title":37,"path":38,"stem":39},"Connecting","/en/mcp/connection","en/2.mcp/1.connection",{"title":41,"path":42,"stem":43},"Envelope","/en/mcp/envelope","en/2.mcp/2.envelope",{"title":45,"path":46,"stem":47},"Resources","/en/mcp/resources","en/2.mcp/3.resources",{"title":49,"path":50,"stem":51,"children":52},"Tools","/en/mcp/tools","en/2.mcp/4.tools/0.index",[53,54,58,62,66,70,74,78,82,86,90,94],{"title":49,"path":50,"stem":51},{"title":55,"path":56,"stem":57},"list_schema_versions","/en/mcp/tools/list-schema-versions","en/2.mcp/4.tools/1.list-schema-versions",{"title":59,"path":60,"stem":61},"MCP tool: resolve_datachain","/en/mcp/tools/resolve-datachain","en/2.mcp/4.tools/10.resolve-datachain",{"title":63,"path":64,"stem":65},"MCP tool: validate_resolved","/en/mcp/tools/validate-resolved","en/2.mcp/4.tools/11.validate-resolved",{"title":67,"path":68,"stem":69},"get_schema","/en/mcp/tools/get-schema","en/2.mcp/4.tools/2.get-schema",{"title":71,"path":72,"stem":73},"list_categories","/en/mcp/tools/list-categories","en/2.mcp/4.tools/3.list-categories",{"title":75,"path":76,"stem":77},"list_elements","/en/mcp/tools/list-elements","en/2.mcp/4.tools/4.list-elements",{"title":79,"path":80,"stem":81},"get_element","/en/mcp/tools/get-element","en/2.mcp/4.tools/5.get-element",{"title":83,"path":84,"stem":85},"get_elements","/en/mcp/tools/get-elements","en/2.mcp/4.tools/6.get-elements",{"title":87,"path":88,"stem":89},"validate_datachain","/en/mcp/tools/validate-datachain","en/2.mcp/4.tools/7.validate-datachain",{"title":91,"path":92,"stem":93},"render_datachain","/en/mcp/tools/render-datachain","en/2.mcp/4.tools/8.render-datachain",{"title":95,"path":96,"stem":97},"get_icon_url","/en/mcp/tools/get-icon-url","en/2.mcp/4.tools/9.get-icon-url",{"title":99,"path":100,"stem":101},"Prompts","/en/mcp/prompts","en/2.mcp/5.prompts",{"title":103,"path":104,"stem":105,"children":106},"REST API (v2)","/en/rest","en/3.rest/0.index",[107,108,112,116,120,124,128,132,136,140,144,148],{"title":103,"path":104,"stem":105},{"title":109,"path":110,"stem":111},"GET /schemas","/en/rest/schemas","en/3.rest/1.schemas",{"title":113,"path":114,"stem":115},"POST /schemas/:version/resolve","/en/rest/resolve","en/3.rest/10.resolve",{"title":117,"path":118,"stem":119},"POST /schemas/:version/validate_resolved","/en/rest/validate-resolved","en/3.rest/11.validate-resolved",{"title":121,"path":122,"stem":123},"GET /schemas/:version/manifest","/en/rest/manifest","en/3.rest/2.manifest",{"title":125,"path":126,"stem":127},"GET /schemas/:version/categories","/en/rest/categories","en/3.rest/3.categories",{"title":129,"path":130,"stem":131},"GET /schemas/:version/elements","/en/rest/elements-list","en/3.rest/4.elements-list",{"title":133,"path":134,"stem":135},"GET /schemas/:version/elements/:element_id","/en/rest/element-detail","en/3.rest/5.element-detail",{"title":137,"path":138,"stem":139},"POST /schemas/:version/validate","/en/rest/validate","en/3.rest/6.validate",{"title":141,"path":142,"stem":143},"Icon routes","/en/rest/icons","en/3.rest/7.icons",{"title":145,"path":146,"stem":147},"Pagination & fields","/en/rest/pagination-and-fields","en/3.rest/8.pagination-and-fields",{"title":149,"path":150,"stem":151},"Errors","/en/rest/errors","en/3.rest/9.errors",{"title":153,"path":154,"stem":155,"children":156},"Icon composition","/en/icons","en/4.icons/0.index",[157,158,162,166,170],{"title":153,"path":154,"stem":155},{"title":159,"path":160,"stem":161},"Shapes","/en/icons/shapes","en/4.icons/1.shapes",{"title":163,"path":164,"stem":165},"Symbols","/en/icons/symbols","en/4.icons/2.symbols",{"title":167,"path":168,"stem":169},"Composed variants","/en/icons/composed-variants","en/4.icons/3.composed-variants",{"title":171,"path":172,"stem":173},"URLs","/en/icons/urls","en/4.icons/4.urls",{"title":175,"path":176,"stem":177,"children":178},"@dtpr/ui","/en/ui","en/5.ui/0.index",[179,180,184,188,192],{"title":175,"path":176,"stem":177},{"title":181,"path":182,"stem":183},"@dtpr/ui/core","/en/ui/core","en/5.ui/1.core",{"title":185,"path":186,"stem":187},"@dtpr/ui/vue","/en/ui/vue","en/5.ui/2.vue",{"title":189,"path":190,"stem":191},"@dtpr/ui/html","/en/ui/html","en/5.ui/3.html",{"title":193,"path":194,"stem":195},"Theming","/en/ui/theming","en/5.ui/4.theming",{"title":197,"path":198,"stem":199,"children":200},"Concepts","/en/concepts","en/6.concepts/0.index",[201,202,206,210,214,218,222],{"title":197,"path":198,"stem":199},{"title":203,"path":204,"stem":205},"Datachains","/en/concepts/datachains","en/6.concepts/1.datachains",{"title":207,"path":208,"stem":209},"Elements & categories","/en/concepts/elements-categories","en/6.concepts/2.elements-categories",{"title":211,"path":212,"stem":213},"Versions & releases","/en/concepts/versions-and-releases","en/6.concepts/3.versions-and-releases",{"title":215,"path":216,"stem":217},"Content hash","/en/concepts/content-hash","en/6.concepts/4.content-hash",{"title":219,"path":220,"stem":221},"Shape contract","/en/concepts/shape-contract","en/6.concepts/5.shape-contract",{"title":223,"path":224,"stem":225},"Subchains","/en/concepts/subchains","en/6.concepts/6.subchains",{"title":227,"path":228,"stem":229,"children":230},"Claude plugin","/en/plugin","en/7.plugin/0.index",[231,232,236,270,274],{"title":227,"path":228,"stem":229},{"title":233,"path":234,"stem":235},"Install","/en/plugin/install","en/7.plugin/1.install",{"title":237,"path":238,"stem":239,"children":240},"Skills","/en/plugin/skills","en/7.plugin/2.skills/0.index",[241,242,246,250,254,258,262,266],{"title":237,"path":238,"stem":239},{"title":243,"path":244,"stem":245},"dtpr-describe-system","/en/plugin/skills/describe-system","en/7.plugin/2.skills/1.describe-system",{"title":247,"path":248,"stem":249},"dtpr-datachain-structure","/en/plugin/skills/datachain-structure","en/7.plugin/2.skills/2.datachain-structure",{"title":251,"path":252,"stem":253},"dtpr-category-audit","/en/plugin/skills/category-audit","en/7.plugin/2.skills/3.category-audit",{"title":255,"path":256,"stem":257},"dtpr-element-design","/en/plugin/skills/element-design","en/7.plugin/2.skills/4.element-design",{"title":259,"path":260,"stem":261},"dtpr-symbol-design","/en/plugin/skills/symbol-design","en/7.plugin/2.skills/5.symbol-design",{"title":263,"path":264,"stem":265},"dtpr-translate","/en/plugin/skills/translate","en/7.plugin/2.skills/6.translate",{"title":267,"path":268,"stem":269},"dtpr-comprehension-audit","/en/plugin/skills/comprehension-audit","en/7.plugin/2.skills/7.comprehension-audit",{"title":271,"path":272,"stem":273},"Research corpus","/en/plugin/research-corpus","en/7.plugin/3.research-corpus",{"title":275,"path":276,"stem":277},"Comprehension rubric","/en/plugin/comprehension-rubric","en/7.plugin/4.comprehension-rubric",{"title":49,"path":279,"stem":280,"children":281},"/en/tools","en/8.tools/0.index",[282],{"title":49,"path":279,"stem":280},{"title":284,"path":285,"stem":286},"Changelog","/en/changelog","en/9.changelog",{"ok":288,"versions":289},true,[290],{"id":291,"status":292,"created_at":293,"content_hash":294},"ai@2026-05-06-beta","beta","2026-05-06T20:23:42.963Z","sha256-2d208111b0c597ff2b38cb1c24168799b0a5ff9290203ebf46c4f7c16a0fcb24",{"id":296,"title":149,"body":297,"description":968,"extension":969,"links":970,"meta":971,"navigation":288,"path":150,"seo":972,"stem":151,"__hash__":973},"docs_en/en/3.rest/9.errors.md",{"type":298,"value":299,"toc":959},"minimark",[300,321,326,487,560,572,576,581,692,696,828,832,842,917,921,955],[301,302,304,305,309,310,312,313,316,317,320],"callout",{"type":303},"info","Every error response — REST or MCP — carries the same ",[306,307,308],"code",{},"{ ok: false, errors: [...] }"," shape. ",[306,311,306],{}," is stable; ",[306,314,315],{},"message"," and ",[306,318,319],{},"fix_hint"," are human-readable.",[322,323,325],"h2",{"id":324},"shape","Shape",[327,328,333],"pre",{"className":329,"code":330,"language":331,"meta":332,"style":332},"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","",[306,334,335,344,363,378,384,409,429,450,469,475,481],{"__ignoreMap":332},[336,337,340],"span",{"class":338,"line":339},"line",1,[336,341,343],{"class":342},"sMK4o","{\n",[336,345,347,350,354,357,360],{"class":338,"line":346},2,[336,348,349],{"class":342},"  \"",[336,351,353],{"class":352},"spNyl","ok",[336,355,356],{"class":342},"\"",[336,358,359],{"class":342},":",[336,361,362],{"class":342}," false,\n",[336,364,366,368,371,373,375],{"class":338,"line":365},3,[336,367,349],{"class":342},[336,369,370],{"class":352},"errors",[336,372,356],{"class":342},[336,374,359],{"class":342},[336,376,377],{"class":342}," [\n",[336,379,381],{"class":338,"line":380},4,[336,382,383],{"class":342},"    {\n",[336,385,387,390,393,395,397,400,404,406],{"class":338,"line":386},5,[336,388,389],{"class":342},"      \"",[336,391,306],{"class":392},"sBMFI",[336,394,356],{"class":342},[336,396,359],{"class":342},[336,398,399],{"class":342}," \"",[336,401,403],{"class":402},"sfazB","element_not_found",[336,405,356],{"class":342},[336,407,408],{"class":342},",\n",[336,410,412,414,416,418,420,422,425,427],{"class":338,"line":411},6,[336,413,389],{"class":342},[336,415,315],{"class":392},[336,417,356],{"class":342},[336,419,359],{"class":342},[336,421,399],{"class":342},[336,423,424],{"class":402},"Element 'missing' not found in ai@2026-04-16-beta.",[336,426,356],{"class":342},[336,428,408],{"class":342},[336,430,432,434,437,439,441,443,446,448],{"class":338,"line":431},7,[336,433,389],{"class":342},[336,435,436],{"class":392},"path",[336,438,356],{"class":342},[336,440,359],{"class":342},[336,442,399],{"class":342},[336,444,445],{"class":402},"elements[0].element_id",[336,447,356],{"class":342},[336,449,408],{"class":342},[336,451,453,455,457,459,461,463,466],{"class":338,"line":452},8,[336,454,389],{"class":342},[336,456,319],{"class":392},[336,458,356],{"class":342},[336,460,359],{"class":342},[336,462,399],{"class":342},[336,464,465],{"class":402},"Use GET /api/v2/schemas/:version/elements to enumerate available element ids.",[336,467,468],{"class":342},"\"\n",[336,470,472],{"class":338,"line":471},9,[336,473,474],{"class":342},"    }\n",[336,476,478],{"class":338,"line":477},10,[336,479,480],{"class":342},"  ]\n",[336,482,484],{"class":338,"line":483},11,[336,485,486],{"class":342},"}\n",[488,489,490,506],"table",{},[491,492,493],"thead",{},[494,495,496,500,503],"tr",{},[497,498,499],"th",{},"Field",[497,501,502],{},"Required",[497,504,505],{},"Meaning",[507,508,509,522,533,549],"tbody",{},[494,510,511,516,519],{},[512,513,514],"td",{},[306,515,306],{},[512,517,518],{},"yes",[512,520,521],{},"Stable machine-readable code from the table below.",[494,523,524,528,530],{},[512,525,526],{},[306,527,315],{},[512,529,518],{},[512,531,532],{},"Human-readable diagnostic.",[494,534,535,539,542],{},[512,536,537],{},[306,538,436],{},[512,540,541],{},"no",[512,543,544,545,548],{},"JSON path into the caller's payload (e.g. ",[306,546,547],{},"elements[3].category_id",").",[494,550,551,555,557],{},[512,552,553],{},[306,554,319],{},[512,556,541],{},[512,558,559],{},"Short actionable instruction.",[561,562,563,564,566,567,571],"p",{},"Adding new ",[306,565,306],{}," values is ",[568,569,570],"strong",{},"additive","; renaming or removing is a breaking change (guarded by snapshot fixtures in the repo).",[322,573,575],{"id":574},"codes","Codes",[577,578,580],"h3",{"id":579},"transport-level-http-status-mirrors-the-code","Transport-level (HTTP status mirrors the code)",[488,582,583,595],{},[491,584,585],{},[494,586,587,590,593],{},[497,588,589],{},"Code",[497,591,592],{},"HTTP",[497,594,505],{},[507,596,597,610,623,636,653,666,679],{},[494,598,599,604,607],{},[512,600,601],{},[306,602,603],{},"bad_request",[512,605,606],{},"400",[512,608,609],{},"Malformed input — version path param, query params, request body, or invalid cursor.",[494,611,612,617,620],{},[512,613,614],{},[306,615,616],{},"not_found",[512,618,619],{},"404",[512,621,622],{},"Unknown version, element, symbol, variant, or shape.",[494,624,625,630,633],{},[512,626,627],{},[306,628,629],{},"payload_too_large",[512,631,632],{},"413",[512,634,635],{},"Request body exceeds the configured byte limit.",[494,637,638,643,646],{},[512,639,640],{},[306,641,642],{},"rate_limited",[512,644,645],{},"429",[512,647,648,649,652],{},"Client exceeded the rate-limit bucket. ",[306,650,651],{},"Retry-After"," header indicates the wait.",[494,654,655,660,663],{},[512,656,657],{},[306,658,659],{},"timeout",[512,661,662],{},"504",[512,664,665],{},"Request exceeded the per-route wall-clock budget.",[494,667,668,673,676],{},[512,669,670],{},[306,671,672],{},"upstream_error",[512,674,675],{},"502",[512,677,678],{},"Schema-store (R2) read failed.",[494,680,681,686,689],{},[512,682,683],{},[306,684,685],{},"internal_error",[512,687,688],{},"500",[512,690,691],{},"Unexpected server error.",[577,693,695],{"id":694},"semantic-surfaced-in-200-bodies","Semantic — surfaced in 200 bodies",[488,697,698,709],{},[491,699,700],{},[494,701,702,704,707],{},[497,703,589],{},[497,705,706],{},"Raised by",[497,708,505],{},[507,710,711,730,750,764,777,798,810],{},[494,712,713,718,724],{},[512,714,715],{},[306,716,717],{},"parse_error",[512,719,720,723],{},[306,721,722],{},"POST /validate",", MCP validate / render",[512,725,726,727,729],{},"Datachain shape failed Zod validation. ",[306,728,436],{}," locates the offending field.",[494,731,732,736,747],{},[512,733,734],{},[306,735,403],{},[512,737,738,739,741,742,744,745],{},"MCP ",[306,740,83],{}," (per-id), MCP ",[306,743,95],{},", MCP ",[306,746,79],{},[512,748,749],{},"Element not present in the version.",[494,751,752,757,761],{},[512,753,754],{},[306,755,756],{},"element_ids_too_many",[512,758,738,759],{},[306,760,83],{},[512,762,763],{},">100 unique ids after dedupe.",[494,765,766,771,774],{},[512,767,768],{},[306,769,770],{},"unknown_version",[512,772,773],{},"MCP tools",[512,775,776],{},"Manifest missing for the resolved version.",[494,778,779,784,788],{},[512,780,781],{},[306,782,783],{},"unknown_variant",[512,785,738,786],{},[306,787,95],{},[512,789,790,791,794,795,797],{},"Variant not in the element's ",[306,792,793],{},"icon_variants",". ",[306,796,319],{}," lists valid variants.",[494,799,800,805,807],{},[512,801,802],{},[306,803,804],{},"invalid_arguments",[512,806,773],{},[512,808,809],{},"Argument failed the tool's Zod input schema.",[494,811,812,815,825],{},[512,813,814],{},"Semantic validator codes",[512,816,817,820,821,820,823],{},[306,818,819],{},"/validate",", ",[306,822,91],{},[306,824,87],{},[512,826,827],{},"Shape-valid but semantically wrong — required categories missing, placement invalid, cardinality violated, etc.",[322,829,831],{"id":830},"rate-limiting","Rate limiting",[561,833,834,835,837,838,841],{},"Read endpoints share one bucket; ",[306,836,722],{}," uses a dedicated tighter bucket. Setting ",[306,839,840],{},"DTPR-Client: \u003Cname>"," opts your traffic into a per-client bucket. On exceed:",[327,843,847],{"className":844,"code":845,"language":846,"meta":332,"style":332},"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",[306,848,849,854,859,864,869,873,878,883,887,892,897,902,907,912],{"__ignoreMap":332},[336,850,851],{"class":338,"line":339},[336,852,853],{},"HTTP/1.1 429 Too Many Requests\n",[336,855,856],{"class":338,"line":346},[336,857,858],{},"Content-Type: application/json\n",[336,860,861],{"class":338,"line":365},[336,862,863],{},"Retry-After: 60\n",[336,865,866],{"class":338,"line":380},[336,867,868],{"emptyLinePlaceholder":288},"\n",[336,870,871],{"class":338,"line":386},[336,872,343],{},[336,874,875],{"class":338,"line":411},[336,876,877],{},"  \"ok\": false,\n",[336,879,880],{"class":338,"line":431},[336,881,882],{},"  \"errors\": [\n",[336,884,885],{"class":338,"line":452},[336,886,383],{},[336,888,889],{"class":338,"line":471},[336,890,891],{},"      \"code\": \"rate_limited\",\n",[336,893,894],{"class":338,"line":477},[336,895,896],{},"      \"message\": \"Rate limit exceeded.\",\n",[336,898,899],{"class":338,"line":483},[336,900,901],{},"      \"fix_hint\": \"Wait 60 seconds or set `DTPR-Client` for a dedicated bucket.\"\n",[336,903,905],{"class":338,"line":904},12,[336,906,474],{},[336,908,910],{"class":338,"line":909},13,[336,911,480],{},[336,913,915],{"class":338,"line":914},14,[336,916,486],{},[322,918,920],{"id":919},"see-also","See also",[922,923,924,940,948],"ul",{},[925,926,927],"li",{},[928,929,931,932,934,935,934,937],"a",{"href":930},"/mcp/envelope","MCP envelope — ",[306,933,353],{},"/",[306,936,370],{},[306,938,939],{},"meta",[925,941,942,947],{},[928,943,945],{"href":944},"/rest/validate",[306,946,137],{}," — semantic validator errors.",[925,949,950],{},[928,951,738,953],{"href":952},"/mcp/tools/validate-datachain",[306,954,87],{},[956,957,958],"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":332,"searchDepth":346,"depth":346,"links":960},[961,962,966,967],{"id":324,"depth":346,"text":325},{"id":574,"depth":346,"text":575,"children":963},[964,965],{"id":579,"depth":365,"text":580},{"id":694,"depth":365,"text":695},{"id":830,"depth":346,"text":831},{"id":919,"depth":346,"text":920},"The shared error shape and canonical code list.","md",null,{},{"title":149,"description":968},"4YDXEFUC47df0J-l16Gyt4axDKoVez6OsDxU5bNJZ9Q",[975,977],{"title":145,"path":146,"stem":147,"description":976,"children":-1},"Cursor semantics, limits, field projection, and locale filtering.",{"title":153,"path":154,"stem":155,"description":978,"children":-1},"Shape × symbol × variant mental model behind every DTPR icon.",1779049694135]