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