One attribute definition by key. type selects the entity type (default product) — keys are namespaced per type, so the wrong type returns 404. Same projection as GET /attributes: the data_type, whether the key is writable, and its parsed acceptable_values. Use this to re-check a single key; use GET /attributes to learn the whole schema.
Workspace-scoped API key (mk_live_...). Each operation lists the scope it requires in x-required-scopes. See the Authentication guide for the full scope table and key management.
Path Parameters
key
string
required
The attribute key.
Query Parameters
type
enum<string>
default:product
The entity type the key belongs to.
Available options:
product,
image,
vendor,
category,
source
Response
The attribute definition.
data
object
The discovery projection of an attribute definition (GET /attributes): what the key is, whether you may write it, and what values it accepts.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Merchkit","description":"Merchkit is an AI-native PIM: import your catalog, enrich it with AI, and publish channel-ready content. Product guides plus the developer reference for the Merchkit API and MCP server.","colors":{"primary":"#3E703F","light":"#6EA570","dark":"#2E5530"},"logo":{"light":"https://mintcdn.com/merchkit/5CX85y_hfwgKe2-R/logo/light.svg?fit=max\u0026auto=format\u0026n=5CX85y_hfwgKe2-R\u0026q=85\u0026s=44793f2cb04c37defc7d3810d29cca0e","dark":"https://mintcdn.com/merchkit/5CX85y_hfwgKe2-R/logo/dark.svg?fit=max\u0026auto=format\u0026n=5CX85y_hfwgKe2-R\u0026q=85\u0026s=bac43fbcffb653a7a2c577fd38a8de4e"},"favicon":"https://mintcdn.com/merchkit/kbLpgBCpSYwwHFZe/favicon.png?fit=max\u0026auto=format\u0026n=kbLpgBCpSYwwHFZe\u0026q=85\u0026s=ae9b1c0fcf22f192729dc47aa4377419","api":{"examples":{"defaults":"required"}},"navbar":{"links":[{"href":"mailto:support@merchkit.com","label":"Support"}],"primary":{"type":"button","label":"Go to App","href":"https://www.merchkit.com/home"}},"footer":{"socials":{"x":"https://x.com/merchkit_","linkedin":"https://www.linkedin.com/company/merchkithq"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"merchkit.com","icon":"house","href":"https://www.merchkit.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"merchkit","hasAudioNarration":false,"actualSubdomain":"merchkit","customDomains":["docs.merchkit.com"],"gitSource":{"type":"github","owner":"merchkit","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af77686fcbcc7142a349e17","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"Product","count":67},{"language":"default","tag":"API \u0026 MCP","count":46},{"language":"default","tag":"API Reference","count":41},{"language":"default","tag":"Catalog","count":30},{"language":"default","tag":"Attributes \u0026 Enrichment","count":17},{"language":"default","tag":"Channels \u0026 Content Generation","count":12},{"language":"default","tag":"Sources \u0026 Importing","count":11},{"language":"default","tag":"Integrations \u0026 Field Mapping","count":10},{"language":"default","tag":"Products","count":8},{"language":"default","tag":"Getting Started","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@merchkit.com","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-one-attribute-definition","slug":"/api-reference/get-one-attribute-definition","pageMetadata":{"title":"Get one attribute definition","description":"One attribute definition by `key`. `type` selects the entity type (default `product`) — keys are namespaced per type, so the wrong `type` returns 404. Same projection as `GET /attributes`: the `data_type`, whether the key is `writable`, and its parsed `acceptable_values`. Use this to re-check a single key; use `GET /attributes` to learn the whole schema.\n\nScope: `read:attributes`.","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /attributes/{key}","href":"/api-reference/get-one-attribute-definition","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"One attribute definition by \", _jsx(_components.code, {\n children: \"key\"\n }), \". \", _jsx(_components.code, {\n children: \"type\"\n }), \" selects the entity type (default \", _jsx(_components.code, {\n children: \"product\"\n }), \") — keys are namespaced per type, so the wrong \", _jsx(_components.code, {\n children: \"type\"\n }), \" returns 404. Same projection as \", _jsx(_components.code, {\n children: \"GET /attributes\"\n }), \": the \", _jsx(_components.code, {\n children: \"data_type\"\n }), \", whether the key is \", _jsx(_components.code, {\n children: \"writable\"\n }), \", and its parsed \", _jsx(_components.code, {\n children: \"acceptable_values\"\n }), \". Use this to re-check a single key; use \", _jsx(_components.code, {\n children: \"GET /attributes\"\n }), \" to learn the whole schema.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Scope: \", _jsx(_components.code, {\n children: \"read:attributes\"\n }), \".\"]\n })]\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":"Get one attribute definition","description":"One attribute definition by `key`. `type` selects the entity type (default `product`) — keys are namespaced per type, so the wrong `type` returns 404. Same projection as `GET /attributes`: the `data_type`, whether the key is `writable`, and its parsed `acceptable_values`. Use this to re-check a single key; use `GET /attributes` to learn the whole schema.\n\nScope: `read:attributes`.","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /attributes/{key}","href":"/api-reference/get-one-attribute-definition","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getAttribute","summary":"Get one attribute definition","description":"One attribute definition by `key`. `type` selects the entity type (default `product`) — keys are namespaced per type, so the wrong `type` returns 404. Same projection as `GET /attributes`: the `data_type`, whether the key is `writable`, and its parsed `acceptable_values`. Use this to re-check a single key; use `GET /attributes` to learn the whole schema.\n\nScope: `read:attributes`.","security":["2f3a35dc-ff32-4a83-8fd9-56300ec1769f"],"x-required-scopes":["read:attributes"],"parameters":["e857d9a7-9c0a-46ac-b459-552bc3dbf24d"],"responses":{"200":"5263bf8c-b269-4aeb-b533-c8c5ce7aedce","404":"34504d1a-5c6c-4ac8-8d82-7a2ea7d01e21"},"method":"get","type":"path","servers":["ae4f6803-6cfa-4dad-ab41-8bd0d862f7b7"],"path":"/attributes/{key}","baseUrlOptions":["https://www.merchkit.com/api/v1"],"title":"Get one attribute definition","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e857d9a7-9c0a-46ac-b459-552bc3dbf24d":{"name":"type","in":"query","schema":{"type":"string","enum":["product","image","vendor","category","source"],"default":"product","description":"The entity type the key belongs to.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"The entity type the key belongs to."},"06d88f60-73ae-4108-a159-735fb88aa368":{"name":"key","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The attribute key.","uniqueKey":"","typeLabel":"string"},"description":"The attribute key."}},"responses":{"5263bf8c-b269-4aeb-b533-c8c5ce7aedce":{"description":"The attribute definition.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"The discovery projection of an attribute definition (`GET /attributes`): what the key is, whether you may write it, and what values it accepts.","required":["id","key","name","entity_type","data_type","channel","is_primary","writable","acceptable_values","default_value","formula_expression"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"key":{"type":"string","description":"The key used in `attributes`, filters, and sorts.","isRequired":true,"uniqueKey":"data.key","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"entity_type":{"type":"string","isRequired":true,"uniqueKey":"data.entity_type","typeLabel":"string"},"data_type":{"type":"string","isRequired":true,"uniqueKey":"data.data_type","typeLabel":"string"},"channel":{"oneOf":[{"type":"string","description":"Set when the attribute is channel-scoped.","isRequired":true,"uniqueKey":"data.channel.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set when the attribute is channel-scoped.","isRequired":true,"uniqueKey":"data.channel.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.channel","typeLabel":"string | null"},"is_primary":{"type":"boolean","description":"The primary attribute supplies every entity's `label`.","isRequired":true,"uniqueKey":"data.is_primary","typeLabel":"boolean"},"writable":{"type":"boolean","description":"False for derived types (formula, inverse_reference, reference_lookup) — writes to them are rejected.","isRequired":true,"uniqueKey":"data.writable","typeLabel":"boolean"},"acceptable_values":{"type":"array","items":{"type":"string","uniqueKey":"data.acceptable_values.items.[INDEX]","typeLabel":"string"},"description":"Parsed allowed values for selects; empty when unconstrained.","isRequired":true,"uniqueKey":"data.acceptable_values","typeLabel":"string[]"},"default_value":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.default_value.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.default_value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.default_value","typeLabel":"string | null"},"formula_expression":{"oneOf":[{"type":"string","description":"The template of a formula or web_preview column; null for every other attribute.","isRequired":true,"uniqueKey":"data.formula_expression.oneOf.0","typeLabel":"string"},{"type":"null","description":"The template of a formula or web_preview column; null for every other attribute.","isRequired":true,"uniqueKey":"data.formula_expression.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.formula_expression","typeLabel":"string | null"}},"example":{"id":"a3d81c22-5f6e-4b09-8d17-c40a92e5b613","key":"material","name":"Material","entity_type":"product","data_type":"single_select_list","channel":null,"is_primary":false,"writable":true,"acceptable_values":["White Oak","Smoked Oak","Walnut"],"default_value":null,"formula_expression":null},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"id":"a3d81c22-5f6e-4b09-8d17-c40a92e5b613","key":"material","name":"Material","entity_type":"product","data_type":"single_select_list","channel":null,"is_primary":false,"writable":true,"acceptable_values":["White Oak","Smoked Oak","Walnut"],"default_value":null,"formula_expression":null}},"examples":{"Example":{"title":"Example","value":{"data":{"id":"a3d81c22-5f6e-4b09-8d17-c40a92e5b613","key":"material","name":"Material","entity_type":"product","data_type":"single_select_list","channel":null,"is_primary":false,"writable":true,"acceptable_values":["White Oak","Smoked Oak","Walnut"],"default_value":null,"formula_expression":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"34504d1a-5c6c-4ac8-8d82-7a2ea7d01e21":{"description":"Attribute not found for that type.","content":{"application/json":{"schema":{"type":"object","description":"The one error envelope every non-2xx response uses. `documentation_url` links to the code's section of the error docs.","required":["error"],"properties":{"error":{"type":"object","required":["code","message","is_retriable"],"properties":{"code":{"type":"string","enum":["unauthorized","insufficient_scope","forbidden","not_found","validation_failed","rate_limited","conflict","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"is_retriable":{"type":"boolean","description":"Only `rate_limited` and `internal_error` are retriable. Deterministic client errors (validation, not-found, conflict) return a 4xx and are never retriable.","isRequired":true,"uniqueKey":"error.is_retriable","typeLabel":"boolean"},"documentation_url":{"type":"string","format":"uri","description":"https://docs.merchkit.com/developers/errors#\u003ccode>","uniqueKey":"error.documentation_url","typeLabel":"string\u003curi>"},"retry_after_seconds":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.retry_after_seconds","typeLabel":"integer | null"},"alternative_action":{"type":"string","description":"What to do instead, when there is a better call.","uniqueKey":"error.alternative_action","typeLabel":"string"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"field_errors":{"type":"array","items":{"type":"object","required":["field","issue"],"properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.field_errors.items.[INDEX].field","typeLabel":"string"},"issue":{"type":"string","description":"Machine-readable issue code, e.g. `not_a_defined_attribute`.","isRequired":true,"uniqueKey":"error.field_errors.items.[INDEX].issue","typeLabel":"string"},"acceptable_values":{"type":"array","items":{"type":"string","uniqueKey":"error.field_errors.items.[INDEX].acceptable_values.items.[INDEX]","typeLabel":"string"},"description":"For select-value violations: the allowed values.","uniqueKey":"error.field_errors.items.[INDEX].acceptable_values","typeLabel":"string[]"}},"uniqueKey":"error.field_errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.field_errors","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"validation_failed","message":"Unknown attribute key(s): colour.","documentation_url":"https://docs.merchkit.com/developers/errors#validation_failed","is_retriable":false,"retry_after_seconds":null,"alternative_action":"List valid attribute keys via GET /v1/attributes?type=product.","request_id":"req_01j9x2k8","field_errors":[{"field":"colour","issue":"not_a_defined_attribute"}]}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_failed","message":"Unknown attribute key(s): colour.","documentation_url":"https://docs.merchkit.com/developers/errors#validation_failed","is_retriable":false,"retry_after_seconds":null,"alternative_action":"List valid attribute keys via GET /v1/attributes?type=product.","request_id":"req_01j9x2k8","field_errors":[{"field":"colour","issue":"not_a_defined_attribute"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2f3a35dc-ff32-4a83-8fd9-56300ec1769f":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Workspace-scoped API key (`mk_live_...`). Each operation lists the scope it requires in `x-required-scopes`. See the Authentication guide for the full scope table and key management.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"ae4f6803-6cfa-4dad-ab41-8bd0d862f7b7":{"url":"https://www.merchkit.com/api/v1","description":"Merchkit API v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Workspace-scoped API key (`mk_live_...`). Each operation lists the scope it requires in `x-required-scopes`. See the Authentication guide for the full scope table and key management.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace-scoped API key (`mk_live_...`). Each operation lists the scope it requires in `x-required-scopes`. See the Authentication guide for the full scope table and key management.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://www.merchkit.com/api/v1/openapi"},"subdomain":"merchkit","siteName":"Merchkit","title":"Get one attribute definition - Merchkit","contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T20:43:27.104Z","originalFileLocation":"api-reference/get-one-attribute-definition.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"system\"}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=\"One attribute definition by key. type selects the entity type (default product) — keys are namespaced per type, so the wrong type returns 404. Same projection as GET /attributes: the data_type, whether the key is writable, and its parsed acceptable_values. Use this to re-check a single key; use GET /attributes to learn the whole schema. Scope: read:attributes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Merchkit\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/merchkit/u9Xu7zNeRpkrmNZE/_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/merchkit/u9Xu7zNeRpkrmNZE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/merchkit/u9Xu7zNeRpkrmNZE/_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/merchkit/u9Xu7zNeRpkrmNZE/_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/merchkit/u9Xu7zNeRpkrmNZE/_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/merchkit/u9Xu7zNeRpkrmNZE/_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/merchkit/u9Xu7zNeRpkrmNZE/_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/merchkit/u9Xu7zNeRpkrmNZE/_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/merchkit/u9Xu7zNeRpkrmNZE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get one attribute definition - Merchkit\">\u003cmeta data-mint-head property=\"og:description\" content=\"One attribute definition by key. type selects the entity type (default product) — keys are namespaced per type, so the wrong type returns 404. Same projection as GET /attributes: the data_type, whether the key is writable, and its parsed acceptable_values. Use this to re-check a single key; use GET /attributes to learn the whole schema. Scope: read:attributes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Merchkit\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.merchkit.com/api-reference/get-one-attribute-definition\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://merchkit.mintlify.site/_mintlify/api/og/v2?division=Schema+%26+configuration\u0026amp;title=Get+one+attribute+definition\u0026amp;description=One+attribute+definition+by+%60key%60.+%60type%60+selects+the+entity+type+%28default+%60product%60%29+%E2%80%94+keys+are+namespaced+per+type%2C+so+the+wrong+%60type%60+returns+404.+Same+proj\u0026amp;theme=06fd1fad2bb810fd43730d53\u0026amp;signature=685eb4256d73b0310b2841850832bb5b788e0adfb1c32ee1ead1176e0152b0fc\">\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=\"Get one attribute definition - Merchkit\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One attribute definition by key. type selects the entity type (default product) — keys are namespaced per type, so the wrong type returns 404. Same projection as GET /attributes: the data_type, whether the key is writable, and its parsed acceptable_values. Use this to re-check a single key; use GET /attributes to learn the whole schema. Scope: read:attributes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://merchkit.mintlify.site/_mintlify/api/og/v2?division=Schema+%26+configuration\u0026amp;title=Get+one+attribute+definition\u0026amp;description=One+attribute+definition+by+%60key%60.+%60type%60+selects+the+entity+type+%28default+%60product%60%29+%E2%80%94+keys+are+namespaced+per+type%2C+so+the+wrong+%60type%60+returns+404.+Same+proj\u0026amp;theme=06fd1fad2bb810fd43730d53\u0026amp;signature=685eb4256d73b0310b2841850832bb5b788e0adfb1c32ee1ead1176e0152b0fc\">\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/merchkit/u9Xu7zNeRpkrmNZE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Merchkit\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3E703F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.merchkit.com/api-reference/get-one-attribute-definition\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-one-attribute-definition.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.merchkit.com/#organization\",\"name\":\"Merchkit\",\"url\":\"https://docs.merchkit.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/merchkit/5CX85y_hfwgKe2-R/logo/light.svg?fit=max\u0026auto=format\u0026n=5CX85y_hfwgKe2-R\u0026q=85\u0026s=44793f2cb04c37defc7d3810d29cca0e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.merchkit.com#website\",\"name\":\"Merchkit\",\"url\":\"https://docs.merchkit.com\",\"publisher\":{\"@id\":\"https://docs.merchkit.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition#webpage\",\"url\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition\",\"name\":\"Get one attribute definition\",\"description\":\"One attribute definition by key. type selects the entity type (default product) — keys are namespaced per type, so the wrong type returns 404. Same projection as GET /attributes: the data_type, whether the key is writable, and its parsed acceptable_values. Use this to re-check a single key; use GET /attributes to learn the whole schema. Scope: read:attributes.\",\"dateModified\":\"2026-11-13T20:43:27.104Z\",\"isPartOf\":{\"@id\":\"https://docs.merchkit.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.merchkit.com/api-reference/list-products\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Schema \u0026 configuration\",\"item\":\"https://docs.merchkit.com/api-reference/list-attribute-definitions-schema-discovery\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get one attribute definition\",\"item\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition#apireference\",\"headline\":\"Get one attribute definition\",\"name\":\"Get one attribute definition\",\"description\":\"One attribute definition by key. type selects the entity type (default product) — keys are namespaced per type, so the wrong type returns 404. Same projection as GET /attributes: the data_type, whether the key is writable, and its parsed acceptable_values. Use this to re-check a single key; use GET /attributes to learn the whole schema. Scope: read:attributes.\",\"url\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition\",\"mainEntityOfPage\":{\"@id\":\"https://docs.merchkit.com/api-reference/get-one-attribute-definition#webpage\"},\"dateModified\":\"2026-11-13T20:43:27.104Z\",\"publisher\":{\"@id\":\"https://docs.merchkit.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.merchkit.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Merchkit\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Merchkit\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/get-one-attribute-definition.md","siteName":"Merchkit","nav":{"global":{"anchors":[{"anchor":"merchkit.com","icon":"house","href":"https://www.merchkit.com"}]},"tabs":[{"tab":"Product","pages":[{"title":"Product","href":""}]},{"tab":"API \u0026 MCP","groups":[{"group":"Guides","pages":[{"title":"API Overview","href":"/developers/overview"},{"title":"Authentication","href":"/developers/authentication"},{"title":"Conventions","href":"/developers/conventions"},{"title":"Errors","href":"/developers/errors"},{"title":"MCP Server","href":"/developers/mcp"}]},{"group":"API Reference","pages":[{"group":"Catalog","pages":[{"group":"Products","pages":[{"title":"List products","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /products","href":"/api-reference/list-products"},{"title":"Create a product","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /products","href":"/api-reference/create-a-product"},{"title":"Get a product","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /products/{id}","href":"/api-reference/get-a-product"},{"title":"Update a product","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi patch /products/{id}","href":"/api-reference/update-a-product"},{"title":"Upsert a product by your own key","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /products/upsert","href":"/api-reference/upsert-a-product-by-your-own-key"},{"title":"Batch create/upsert products","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /products/batch","href":"/api-reference/batch-createupsert-products"},{"title":"List a product's variants","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /products/{id}/variants","href":"/api-reference/list-a-products-variants"},{"title":"List a product's references, with positions","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /products/{id}/references","href":"/api-reference/list-a-products-references-with-positions"}]},{"group":"Images","pages":[{"title":"List images","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /images","href":"/api-reference/list-images"},{"title":"Create an image","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /images","href":"/api-reference/create-an-image"},{"title":"Get an image","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /images/{id}","href":"/api-reference/get-an-image"},{"title":"Update an image","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi patch /images/{id}","href":"/api-reference/update-an-image"},{"title":"Upsert an image by your own key","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /images/upsert","href":"/api-reference/upsert-an-image-by-your-own-key"},{"title":"Batch create/upsert images","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /images/batch","href":"/api-reference/batch-createupsert-images"}]},{"group":"Vendors","pages":[{"title":"List vendors","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /vendors","href":"/api-reference/list-vendors"},{"title":"Create a vendor","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /vendors","href":"/api-reference/create-a-vendor"},{"title":"Get a vendor","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /vendors/{id}","href":"/api-reference/get-a-vendor"},{"title":"Update a vendor","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi patch /vendors/{id}","href":"/api-reference/update-a-vendor"},{"title":"Upsert a vendor by your own key","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /vendors/upsert","href":"/api-reference/upsert-a-vendor-by-your-own-key"},{"title":"Batch create/upsert vendors","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /vendors/batch","href":"/api-reference/batch-createupsert-vendors"}]},{"group":"Categories","pages":[{"title":"List categories","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /categories","href":"/api-reference/list-categories"},{"title":"Create a category","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /categories","href":"/api-reference/create-a-category"},{"title":"Get a category","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /categories/{id}","href":"/api-reference/get-a-category"},{"title":"Update a category","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi patch /categories/{id}","href":"/api-reference/update-a-category"},{"title":"Upsert a category by your own key","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /categories/upsert","href":"/api-reference/upsert-a-category-by-your-own-key"},{"title":"Batch create/upsert categories","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /categories/batch","href":"/api-reference/batch-createupsert-categories"}]},{"group":"Sources","pages":[{"title":"List sources","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /sources","href":"/api-reference/list-sources"},{"title":"Create a source (async)","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /sources","href":"/api-reference/create-a-source-async"},{"title":"Get a source","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /sources/{id}","href":"/api-reference/get-a-source"},{"title":"Update a source","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi patch /sources/{id}","href":"/api-reference/update-a-source"}]}]},{"group":"Schema \u0026 configuration","pages":[{"title":"List attribute definitions (schema discovery)","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /attributes","href":"/api-reference/list-attribute-definitions-schema-discovery"},{"title":"Create an attribute definition","description":"Create an attribute, including full AI-generation config (snake_case body). For an AI-generated attribute set `ai_generated: true` + `custom_instructions` (reference other attributes with `{{key}}`), and pick `selected_tools`: `includeWebSearch` (live web research), `includeDataSources` (scraped sites/CSVs), `includeImages` (vision), `includeProductAttributes`. Image/video generation models are supported. `inheritance_mode` shares a value across a variant family (products only).\n\nScope: `write:attributes`.","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi post /attributes","href":"/api-reference/create-an-attribute-definition"},{"title":"Get one attribute definition","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /attributes/{key}","href":"/api-reference/get-one-attribute-definition"},{"title":"Update an attribute definition","description":"Identified by the path `key` + `entity_type` in the body. Provide only the fields to change; array fields replace wholesale.\n\nScope: `write:attributes`.","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi patch /attributes/{key}","href":"/api-reference/update-an-attribute-definition"},{"title":"List enabled channels","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /channels","href":"/api-reference/list-enabled-channels"}]},{"group":"Channel readiness","pages":[{"title":"Check completeness for a channel","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /products/{id}/completeness","href":"/api-reference/check-completeness-for-a-channel"}]},{"group":"Sync \u0026 monitoring","pages":[{"title":"Workspace change feed","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /events","href":"/api-reference/workspace-change-feed"},{"title":"List a product's change events","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /products/{id}/events","href":"/api-reference/list-a-products-change-events"},{"title":"List recent jobs","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /jobs","href":"/api-reference/list-recent-jobs"},{"title":"Poll an async job","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /jobs/{id}","href":"/api-reference/poll-an-async-job"}]},{"group":"Spec","pages":[{"title":"This OpenAPI document","deprecated":null,"version":null,"openapi":"https://www.merchkit.com/api/v1/openapi get /openapi","href":"/api-reference/this-openapi-document"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get one attribute definition - Merchkit","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}