---
title: "Product Layer Metaproperties API"
url: "https://earlyaccess.developers.bynder.com/apis/product-layer-metaproperties-api-1/versions/2fb2c968-3ea1-4674-8bb7-a5babf8f5934"
---

# Product Layer Metaproperties API

OpenAPI specification document.

```json
{"components":{"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://{your-auth-url}","scopes":{"METAPROPERTYMANAGEMENT":"","metaproperty.view":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"},"clientCredentials":{"scopes":{"METAPROPERTYMANAGEMENT":"","metaproperty.view":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"}},"type":"oauth2"},"permanentToken":{"in":"header","name":"Authorization","type":"apiKey"}}},"info":{"title":"Product Layer Metaproperties API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/pim/metaproperties":{"get":{"description":"Retrieve a list of metaproperties.","responses":{"200":{"content":{"application/json":{"schema":{"items":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"type":"array"}}},"description":"Successfully retrieved metaproperties"}},"security":[{"OAuth2":["metaproperty.view"]},{"permanentToken":["metaproperty.view"]}],"summary":"Retrieve metaproperties","tags":["Metaproperties"]}},"/api/pim/metaproperties/{id}":{"get":{"description":"Retrieve the details of a specific metaproperty.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000-0000000000000000","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"description":{"example":"Metaproperty for Product A","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"label":{"example":"Product A","type":"string"},"mp_options":{"items":{"properties":{"description":{"example":"Metaproperty option 1 for Product A","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"label":{"example":"Product A option 1","type":"string"},"metapropertyid":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"name":{"example":"Product A option 1","type":"string"},"relations":{"items":{"properties":{"description":{"example":"Metaproperty option 1 for Product B","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"label":{"example":"Product B option 1","type":"string"},"metapropertyid":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"name":{"example":"Product B option 1","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"name":{"example":"Product A","type":"string"}},"type":"object"}}},"description":"Successfully retrieved specific metaproperty"}},"security":[{"OAuth2":["METAPROPERTYMANAGEMENT"]},{"permanentToken":["METAPROPERTYMANAGEMENT"]}],"summary":"Retrieve specific metaproperty","tags":["Metaproperties"]}},"/api/pim/metaproperties/{id}/options":{"get":{"description":"Retrieve a paginated list of options for the given metaproperty id.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000-0000000000000000","type":"string"}},{"in":"query","name":"order","required":false,"schema":{"enum":["asc","desc"],"example":"asc","type":"string"}},{"in":"query","name":"page","required":false,"schema":{"example":1,"type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"example":20,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"properties":{"description":{"example":"Metaproperty option 1 for Product A","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"label":{"example":"Product A option 1","type":"string"},"metapropertyid":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"name":{"example":"Product A option 1","type":"string"},"product_options":{"items":{"properties":{"description":{"example":"Metaproperty option 1 child","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"label":{"example":"Product A option 1 child","type":"string"},"metapropertyid":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"name":{"example":"Product A option 1 child","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"}}},"description":"Successfully retrieved metaproperty options"}},"security":[{"OAuth2":["METAPROPERTYMANAGEMENT"]},{"permanentToken":["METAPROPERTYMANAGEMENT"]}],"summary":"Retrieve metaproperty options","tags":["Options"]}},"/api/pim/metapropertyoptions/{id}":{"put":{"description":"Edit the children of a metaproperty option.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000-0000000000000000","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"children":{"items":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"204":{"description":"Metaproperty option modified successfully"}},"security":[{"OAuth2":[]},{"permanentToken":[]}],"summary":"Modify metaproperty option","tags":["Options"]}}},"servers":[{"url":"https://{your-bynder-domain}/"}],"tags":[{"description":"","name":"Metaproperties"},{"description":"","name":"Options"}]}
```