{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Forge","colors":{"primary":"#7c3aed","light":"#7c3aed","dark":"#09090b"},"favicon":"/favicon.svg","logo":{"light":"https://mintcdn.com/forge/6FDauhoreGw-hoqJ/logo/light.svg?fit=max\u0026auto=format\u0026n=6FDauhoreGw-hoqJ\u0026q=85\u0026s=a8fc778c37027b402369ae34eefa2302","dark":"https://mintcdn.com/forge/6FDauhoreGw-hoqJ/logo/dark.svg?fit=max\u0026auto=format\u0026n=6FDauhoreGw-hoqJ\u0026q=85\u0026s=3241213043f0c1de2092feee9939c93b"},"appearance":{"default":"dark","strict":true},"navbar":{"links":[{"label":"Support","href":"mailto:support@forge-games.xyz"}],"primary":{"type":"button","label":"Get Started","href":"https://forgegames.org"}},"footer":{"socials":{"github":"https://github.com/buildwithforge","linkedin":"https://www.linkedin.com/company/forgegames"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"forge","hasAudioNarration":false,"actualSubdomain":"forge","customDomains":["docs.forgegames.org"],"gitSource":{"type":"github","owner":"benox3","repo":"forge","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c54bfc6c845dd4133bdb","collectionId":"23ec8ecf-e452-4ba9-ae46-f059326810c5","schemaVersion":"v2"},"entitlements":{},"buildId":"6a20c54bfc6c845dd4133bdb:success","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":37},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"templates","count":6},{"language":"default","tag":"items","count":5},{"language":"default","tag":"Essentials","count":4},{"language":"default","tag":"Integration","count":4},{"language":"default","tag":"attributes","count":4},{"language":"default","tag":"classifiers","count":4},{"language":"default","tag":"item-instances","count":4},{"language":"default","tag":"spaces","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navbar-transition img{height:40px}"}],"page":{"pagePath":"api-reference/items/create-item","slug":"/api-reference/items/create-item","pageMetadata":{"title":"Create Item","description":"Creates a new item blueprint with specified attributes and classifiers.","deprecated":null,"version":null,"openapi":"swagger.json post /items","href":"/api-reference/items/create-item","autogeneratedByOpenApi":true,"hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a new item blueprint with specified attributes and classifiers.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Item","description":"Creates a new item blueprint with specified attributes and classifiers.","deprecated":null,"version":null,"openapi":"swagger.json post /items","href":"/api-reference/items/create-item","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"items-create","summary":"Create Item","description":"Creates a new item blueprint with specified attributes and classifiers.","tags":["items"],"security":["8c77c4e1-e448-4a30-81f2-0600b3245e9b"],"requestBody":"1a7671cf-3884-470d-9e70-3b8d2dddcb87","responses":{"200":"d6648148-1bd4-4cd4-98e5-1658c23e2105","400":"c0c11198-04ef-4fc6-b1dd-af2a714c8aa8","401":"3a19cb92-8629-46b9-a599-960420823e29","403":"7a9e1530-bda2-4890-85bc-d53f3a53bc9f","500":"fc95097b-00b2-4dfd-9631-28732b2c482f"},"method":"post","type":"path","servers":["ab637ea8-5847-4543-abb5-a977f5d721d8"],"path":"/items","baseUrlOptions":["https://forgegames.org/api"],"title":"Create Item","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"rollNumerator":{"type":"number","isRequired":true,"uniqueKey":"rollNumerator","typeLabel":"number"},"classifierOptionIds":{"type":"array","items":{"type":"string","uniqueKey":"classifierOptionIds.items.[INDEX]","typeLabel":"string"},"description":"The classifier options to which this item has been assigned","isRequired":true,"uniqueKey":"classifierOptionIds","typeLabel":"string[]"},"itemAttributes":{"type":"array","items":{"type":"object","properties":{"attributeId":{"type":"string","isRequired":true,"uniqueKey":"itemAttributes.items.[INDEX].attributeId","typeLabel":"string"},"min":{"type":"number","isRequired":true,"uniqueKey":"itemAttributes.items.[INDEX].min","typeLabel":"number"},"max":{"type":"number","isRequired":true,"uniqueKey":"itemAttributes.items.[INDEX].max","typeLabel":"number"}},"required":["attributeId","min","max"],"uniqueKey":"itemAttributes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"itemAttributes","typeLabel":"object[]"},"id":{"type":"string","maxLength":191,"uniqueKey":"id","typeLabel":"string"},"thumbnail":{"oneOf":[{"type":"string","maxLength":191,"uniqueKey":"thumbnail.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":191,"uniqueKey":"thumbnail.oneOf.1","typeLabel":"null"}],"uniqueKey":"thumbnail","typeLabel":"string | null"},"createdAt":{"type":"string","uniqueKey":"createdAt","typeLabel":"string"},"updatedAt":{"oneOf":[{"type":"string","uniqueKey":"updatedAt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"updatedAt","typeLabel":"string | null"}},"required":["name","rollNumerator","classifierOptionIds","itemAttributes"],"description":"Creates a item","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","rollNumerator":123,"classifierOptionIds":["\u003cstring>"],"itemAttributes":[{"attributeId":"\u003cstring>","min":123,"max":123}],"id":"\u003cstring>","thumbnail":"\u003cstring>","createdAt":"\u003cstring>","updatedAt":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d6648148-1bd4-4cd4-98e5-1658c23e2105":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"thumbnail":{"oneOf":[{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"thumbnail.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":191,"isRequired":true,"uniqueKey":"thumbnail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"thumbnail","typeLabel":"string | null"},"rollNumerator":{"type":"number","isRequired":true,"uniqueKey":"rollNumerator","typeLabel":"number"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string"},"updatedAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"updatedAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string | null"},"teamId":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"teamId","typeLabel":"string"},"classifiers":{"type":"array","items":{"type":"object","properties":{"classifierId":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierId","typeLabel":"string"},"classifierOption":{"type":"object","properties":{"id":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierOption.id","typeLabel":"string"},"name":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierOption.name","typeLabel":"string"},"dropRateMultiplier":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierOption.dropRateMultiplier.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierOption.dropRateMultiplier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierOption.dropRateMultiplier","typeLabel":"number | null"},"classifierId":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierOption.classifierId","typeLabel":"string"}},"required":["id","name","dropRateMultiplier","classifierId"],"isRequired":true,"uniqueKey":"classifiers.items.[INDEX].classifierOption","typeLabel":"object"}},"required":["classifierId","classifierOption"],"uniqueKey":"classifiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"classifiers","typeLabel":"object[]"},"attributes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"attributes.items.[INDEX].id","typeLabel":"string"},"itemId":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"attributes.items.[INDEX].itemId","typeLabel":"string"},"attributeId":{"type":"string","maxLength":191,"isRequired":true,"uniqueKey":"attributes.items.[INDEX].attributeId","typeLabel":"string"},"min":{"type":"number","isRequired":true,"uniqueKey":"attributes.items.[INDEX].min","typeLabel":"number"},"max":{"type":"number","isRequired":true,"uniqueKey":"attributes.items.[INDEX].max","typeLabel":"number"}},"required":["id","itemId","attributeId","min","max"],"uniqueKey":"attributes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"attributes","typeLabel":"object[]"}},"required":["id","name","thumbnail","rollNumerator","createdAt","updatedAt","teamId","classifiers","attributes"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","name":"\u003cstring>","thumbnail":"\u003cstring>","rollNumerator":123,"createdAt":"\u003cstring>","updatedAt":"\u003cstring>","teamId":"\u003cstring>","classifiers":[{"classifierId":"\u003cstring>","classifierOption":{"id":"\u003cstring>","name":"\u003cstring>","dropRateMultiplier":123,"classifierId":"\u003cstring>"}}],"attributes":[{"id":"\u003cstring>","itemId":"\u003cstring>","attributeId":"\u003cstring>","min":123,"max":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"c0c11198-04ef-4fc6-b1dd-af2a714c8aa8":{"description":"Invalid input data","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Invalid input data","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"The error code","example":"BAD_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"An array of issues that were responsible for the error","example":[],"uniqueKey":"issues","typeLabel":"object[]"}},"required":["message","code"],"title":"Invalid input data error (400)","description":"The error information","example":{"code":"BAD_REQUEST","message":"Invalid input data","issues":[]},"uniqueKey":"","typeLabel":"Invalid input data error (400) · object"},"examples":{"Example":{"title":"Example","value":{"code":"BAD_REQUEST","message":"Invalid input data","issues":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"3a19cb92-8629-46b9-a599-960420823e29":{"description":"Authorization not provided","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Authorization not provided","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"The error code","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"An array of issues that were responsible for the error","example":[],"uniqueKey":"issues","typeLabel":"object[]"}},"required":["message","code"],"title":"Authorization not provided error (401)","description":"The error information","example":{"code":"UNAUTHORIZED","message":"Authorization not provided","issues":[]},"uniqueKey":"","typeLabel":"Authorization not provided error (401) · object"},"examples":{"Example":{"title":"Example","value":{"code":"UNAUTHORIZED","message":"Authorization not provided","issues":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"7a9e1530-bda2-4890-85bc-d53f3a53bc9f":{"description":"Insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Insufficient access","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"The error code","example":"FORBIDDEN","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"An array of issues that were responsible for the error","example":[],"uniqueKey":"issues","typeLabel":"object[]"}},"required":["message","code"],"title":"Insufficient access error (403)","description":"The error information","example":{"code":"FORBIDDEN","message":"Insufficient access","issues":[]},"uniqueKey":"","typeLabel":"Insufficient access error (403) · object"},"examples":{"Example":{"title":"Example","value":{"code":"FORBIDDEN","message":"Insufficient access","issues":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"fc95097b-00b2-4dfd-9631-28732b2c482f":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Internal server error","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"The error code","example":"INTERNAL_SERVER_ERROR","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"An array of issues that were responsible for the error","example":[],"uniqueKey":"issues","typeLabel":"object[]"}},"required":["message","code"],"title":"Internal server error error (500)","description":"The error information","example":{"code":"INTERNAL_SERVER_ERROR","message":"Internal server error","issues":[]},"uniqueKey":"","typeLabel":"Internal server error error (500) · object"},"examples":{"Example":{"title":"Example","value":{"code":"INTERNAL_SERVER_ERROR","message":"Internal server error","issues":[]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8c77c4e1-e448-4a30-81f2-0600b3245e9b":{"BasicAuth":{"type":"http","scheme":"basic","scopes":[]}}},"servers":{"ab637ea8-5847-4543-abb5-a977f5d721d8":{"url":"https://forgegames.org/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[]},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"BasicAuth","name":"Authorization"}],"title":"BasicAuth"}]},"originalFileLocation":"swagger.json"},"subdomain":"forge","siteName":"Forge","title":"Create Item - Forge","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-02T00:50:27.454Z","originalFileLocation":"api-reference/items/create-item.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a new item blueprint with specified attributes and classifiers.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Forge\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Item - Forge\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new item blueprint with specified attributes and classifiers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Forge\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.forgegames.org/api-reference/items/create-item\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://forge.mintlify.app/_mintlify/api/og/v2?division=items\u0026amp;title=Create+Item\u0026amp;description=Creates+a+new+item+blueprint+with+specified+attributes+and+classifiers.\u0026amp;theme=119ab601b15ba778025f4b86\u0026amp;signature=b532898ae9d370a152103fcb2d2fdc7f6d4939026dca7fbcc618da13914598ab\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Item - Forge\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new item blueprint with specified attributes and classifiers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://forge.mintlify.app/_mintlify/api/og/v2?division=items\u0026amp;title=Create+Item\u0026amp;description=Creates+a+new+item+blueprint+with+specified+attributes+and+classifiers.\u0026amp;theme=119ab601b15ba778025f4b86\u0026amp;signature=b532898ae9d370a152103fcb2d2fdc7f6d4939026dca7fbcc618da13914598ab\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/forge/Vkorqzj0THNL-o9r/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Forge\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7c3aed\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.forgegames.org/api-reference/items/create-item\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/items/create-item.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.forgegames.org/#organization\",\"name\":\"Forge\",\"url\":\"https://docs.forgegames.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/forge/6FDauhoreGw-hoqJ/logo/light.svg?fit=max\u0026auto=format\u0026n=6FDauhoreGw-hoqJ\u0026q=85\u0026s=a8fc778c37027b402369ae34eefa2302\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.forgegames.org#website\",\"name\":\"Forge\",\"url\":\"https://docs.forgegames.org\",\"publisher\":{\"@id\":\"https://docs.forgegames.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.forgegames.org/api-reference/items/create-item#webpage\",\"url\":\"https://docs.forgegames.org/api-reference/items/create-item\",\"name\":\"Create Item\",\"description\":\"Creates a new item blueprint with specified attributes and classifiers.\",\"dateModified\":\"2026-02-02T00:50:27.454Z\",\"isPartOf\":{\"@id\":\"https://docs.forgegames.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.forgegames.org/api-reference/items/create-item#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.forgegames.org/api-reference/items/create-item#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"items\",\"item\":\"https://docs.forgegames.org/api-reference/items/list-items\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Item\",\"item\":\"https://docs.forgegames.org/api-reference/items/create-item\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.forgegames.org/api-reference/items/create-item#apireference\",\"headline\":\"Create Item\",\"name\":\"Create Item\",\"description\":\"Creates a new item blueprint with specified attributes and classifiers.\",\"url\":\"https://docs.forgegames.org/api-reference/items/create-item\",\"mainEntityOfPage\":{\"@id\":\"https://docs.forgegames.org/api-reference/items/create-item#webpage\"},\"dateModified\":\"2026-02-02T00:50:27.454Z\",\"publisher\":{\"@id\":\"https://docs.forgegames.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.forgegames.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Forge\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Forge","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"square-terminal","groups":[{"group":"attributes","pages":[{"title":"List Attributes","deprecated":null,"version":null,"openapi":"swagger.json get /attributes","href":"/api-reference/attributes/list-attributes"},{"title":"Create Attribute","deprecated":null,"version":null,"openapi":"swagger.json post /attributes","href":"/api-reference/attributes/create-attribute"},{"title":"Update Attribute","deprecated":null,"version":null,"openapi":"swagger.json put /attributes/{id}","href":"/api-reference/attributes/update-attribute"},{"title":"Delete Attribute","deprecated":null,"version":null,"openapi":"swagger.json delete /attributes/{id}","href":"/api-reference/attributes/delete-attribute"}]},{"group":"classifiers","pages":[{"title":"List Classifiers","deprecated":null,"version":null,"openapi":"swagger.json get /classifiers","href":"/api-reference/classifiers/list-classifiers"},{"title":"Create Classifier","deprecated":null,"version":null,"openapi":"swagger.json post /classifiers","href":"/api-reference/classifiers/create-classifier"},{"title":"Update Classifier","deprecated":null,"version":null,"openapi":"swagger.json put /classifiers/{id}","href":"/api-reference/classifiers/update-classifier"},{"title":"Delete Classifier","deprecated":null,"version":null,"openapi":"swagger.json delete /classifiers/{id}","href":"/api-reference/classifiers/delete-classifier"}]},{"group":"items","pages":[{"title":"List Items","description":"Lists all items associated with the specified team. Items are blueprints that can be rolled, modified, or assigned attributes.","deprecated":null,"version":null,"openapi":"swagger.json get /items","href":"/api-reference/items/list-items"},{"title":"Create Item","deprecated":null,"version":null,"openapi":"swagger.json post /items","href":"/api-reference/items/create-item"},{"title":"Update Item","description":"Updates an existing item's properties, attributes, and classifiers.","deprecated":null,"version":null,"openapi":"swagger.json put /items/{id}","href":"/api-reference/items/update-item"},{"title":"Delete Item","deprecated":null,"version":null,"openapi":"swagger.json delete /items/{id}","href":"/api-reference/items/delete-item"},{"title":"Roll an item","deprecated":null,"version":null,"openapi":"swagger.json post /items/roll","href":"/api-reference/items/roll-an-item"}]},{"group":"item-instances","pages":[{"title":"List Item Instances","deprecated":null,"version":null,"openapi":"swagger.json get /item-instances","href":"/api-reference/item-instances/list-item-instances"},{"title":"Create an Item Instance","deprecated":null,"version":null,"openapi":"swagger.json post /item-instances","href":"/api-reference/item-instances/create-an-item-instance"},{"title":"Delete an Item Instance","deprecated":null,"version":null,"openapi":"swagger.json delete /item-instances/{id}","href":"/api-reference/item-instances/delete-an-item-instance"},{"title":"Move an Item Instance","deprecated":null,"version":null,"openapi":"swagger.json post /item-instances/{id}/move","href":"/api-reference/item-instances/move-an-item-instance"}]},{"group":"roll-events","pages":[{"title":"Track Roll Event","deprecated":null,"version":null,"openapi":"swagger.json post /roll-events","href":"/api-reference/roll-events/track-roll-event"},{"title":"Get Aggregated Roll Statistics","deprecated":null,"version":null,"openapi":"swagger.json get /roll-events/stats","href":"/api-reference/roll-events/get-aggregated-roll-statistics"},{"title":"Get Item Drop Rates","deprecated":null,"version":null,"openapi":"swagger.json get /roll-events/drop-rates","href":"/api-reference/roll-events/get-item-drop-rates"}]},{"group":"spaces","pages":[{"title":"List Spaces","deprecated":null,"version":null,"openapi":"swagger.json get /spaces","href":"/api-reference/spaces/list-spaces"},{"title":"Create Space","deprecated":null,"version":null,"openapi":"swagger.json post /spaces","href":"/api-reference/spaces/create-space"},{"title":"Update Space","deprecated":null,"version":null,"openapi":"swagger.json put /spaces/{id}","href":"/api-reference/spaces/update-space"},{"title":"Delete Space","deprecated":null,"version":null,"openapi":"swagger.json delete /spaces/{id}","href":"/api-reference/spaces/delete-space"}]},{"group":"templates","pages":[{"title":"List Templates","deprecated":null,"version":null,"openapi":"swagger.json get /templates","href":"/api-reference/templates/list-templates"},{"title":"Create Template","deprecated":null,"version":null,"openapi":"swagger.json post /templates","href":"/api-reference/templates/create-template"},{"title":"Get Template by ID","deprecated":null,"version":null,"openapi":"swagger.json get /templates/{id}","href":"/api-reference/templates/get-template-by-id"},{"title":"Update Template","deprecated":null,"version":null,"openapi":"swagger.json put /templates/{id}","href":"/api-reference/templates/update-template"},{"title":"Delete Template","deprecated":null,"version":null,"openapi":"swagger.json delete /templates/{id}","href":"/api-reference/templates/delete-template"},{"title":"Get Templates by Type","deprecated":null,"version":null,"openapi":"swagger.json get /templates/type/{type}","href":"/api-reference/templates/get-templates-by-type"}]},{"group":"users","pages":[{"title":"List Users","deprecated":null,"version":null,"openapi":"swagger.json get /users","href":"/api-reference/users/list-users"},{"title":"Create a user","deprecated":null,"version":null,"openapi":"swagger.json post /users","href":"/api-reference/users/create-a-user"},{"title":"Delete a user","deprecated":null,"version":null,"openapi":"swagger.json delete /users","href":"/api-reference/users/delete-a-user"}]},{"group":"user-spaces","pages":[{"title":"List user spaces","deprecated":null,"version":null,"openapi":"swagger.json get /users/{userId}/spaces","href":"/api-reference/user-spaces/list-user-spaces"},{"title":"Create a user space","deprecated":null,"version":null,"openapi":"swagger.json post /users/{userId}/spaces","href":"/api-reference/user-spaces/create-a-user-space"},{"title":"Delete a user space","deprecated":null,"version":null,"openapi":"swagger.json delete /users/{userId}/spaces/{id}","href":"/api-reference/user-spaces/delete-a-user-space"}]},{"group":"item-instance-spaces","pages":[{"title":"List Item Instance Spaces","deprecated":null,"version":null,"openapi":"swagger.json get /item-instance-spaces","href":"/api-reference/item-instance-spaces/list-item-instance-spaces"}]}]}]},"title":"Create Item - Forge","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}