---
title: "Dependencies for Metaproperties and Options"
url: "https://earlyaccess.developers.bynder.com/apis/dependencies-for-metaproperties-and-options-1/versions/93f6af18-64b3-4b53-b2d7-016f8c7b9b97"
---

# Dependencies for Metaproperties and Options

OpenAPI specification document.

```json
{"components":{"schemas":{"ListOptionsOutput":{"properties":{"metadata":{"$ref":"#/components/schemas/MetadataOutput"},"options":{"items":{"$ref":"#/components/schemas/MetapropertyOption"},"type":"array"}},"required":["metadata","options"],"type":"object"},"MetadataOutput":{"properties":{"nextPage":{"type":"string"},"prevPage":{"type":"string"}},"type":"object"},"MetapropertyNotExistingOutput1":{"properties":{"errorCode":{"type":"string"},"message":{"type":"string"}},"required":["errorCode","message"],"type":"object"},"MetapropertyOption":{"properties":{"externalReference":{"type":"string"},"icon":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name","externalReference","icon"],"type":"object"},"OptionListCursorFormatInvalidOutput":{"properties":{"errorCode":{"type":"string"},"message":{"type":"string"}},"required":["errorCode","message"],"type":"object"},"OptionListCursorParameterInvalidOutput":{"properties":{"errorCode":{"type":"string"},"message":{"type":"string"}},"required":["errorCode","message"],"type":"object"},"OptionListInvalidOutput":{"oneOf":[{"$ref":"#/components/schemas/OptionListCursorFormatInvalidOutput"},{"$ref":"#/components/schemas/OptionListCursorParameterInvalidOutput"}],"type":"object"}},"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://{your-auth-url}","scopes":{"METAMANAGEMENT":"","METAPROPERTYMANAGEMENT":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"},"clientCredentials":{"scopes":{"METAMANAGEMENT":"","METAPROPERTYMANAGEMENT":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"}},"type":"oauth2"},"permanentToken":{"in":"header","name":"Authorization","type":"apiKey"}}},"info":{"title":"Dependencies for Metaproperties and Options","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v4/metaproperties/options/dependencies":{"get":{"description":"Retrieve all metaproperty option dependencies globally.","responses":{"200":{"content":{"application/json":{"examples":{"example1":{"value":{"00000000-0000-0000-0000000000000000":{"00000000-0000-0000-0000000000000000":{"00000000-0000-0000-0000000000000000":["00000000-0000-0000-0000000000000000","00000000-0000-0000-0000000000000001","00000000-0000-0000-0000000000000002"]}},"00000000-0000-0000-0000000000000001":{"00000000-0000-0000-0000000000000000":{"ungrouped":["00000000-0000-0000-0000000000000000","00000000-0000-0000-0000000000000001"]}}}}},"schema":{"additionalProperties":{"additionalProperties":{"additionalProperties":{"items":{"example":"00000000-0000-0000-0000000000000000","type":"string"},"type":"array"},"type":"object"},"type":"object"},"type":"object"}}},"description":"A list of global option dependencies."}},"summary":"Retrieve global option dependencies","tags":["Option dependency (Please use new Automations API if possible)"]}},"/api/v4/metaproperties/{id}/options/dependencies":{"get":{"description":"Retrieve all metaproperty option dependencies for a specific metaproperty.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example1":{"value":{"00000000-0000-0000-0000000000000000":{"00000000-0000-0000-0000000000000000":["00000000-0000-0000-0000000000000000","00000000-0000-0000-0000000000000001","00000000-0000-0000-0000000000000002"],"ungrouped":["00000000-0000-0000-0000000000000000"]}}}},"schema":{"additionalProperties":{"additionalProperties":{"items":{"example":"00000000-0000-0000-0000000000000000","type":"string"},"type":"array"},"type":"object"},"type":"object"}}},"description":"A list of metaproperty option dependencies."},"404":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"Unknown metaproperty","type":"string"},"statuscode":{"example":"404","type":"string"}},"type":"object"}}},"description":"Unknown metaproperty"}},"summary":"Retrieve option dependencies for a metaproperty","tags":["Option dependency (Please use new Automations API if possible)"]}},"/api/v4/metaproperties/{id}/options/{optionId}/dependencies":{"get":{"description":"Retrieve dependencies for a metaproperty option.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"optionId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"query","name":"includeGroupedResults","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example1":{"value":["00000000-0000-0000-0000000000000000","00000000-0000-0000-0000000000000001"]},"example2":{"value":{"00000000-0000-0000-0000000000000000":["00000000-0000-0000-0000000000000000","00000000-0000-0000-0000000000000001","00000000-0000-0000-0000000000000002"],"ungrouped":["00000000-0000-0000-0000000000000000"]}}},"schema":{"oneOf":[{"items":{"example":"00000000-0000-0000-0000000000000000","type":"string"},"type":"array"},{"additionalProperties":{"items":{"example":"00000000-0000-0000-0000000000000000","type":"string"},"type":"array"},"type":"object"}]}}},"description":"A list of specific metaproperty option dependencies."},"404":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"Unknown metaproperty","type":"string"},"statuscode":{"example":"404","type":"string"}},"type":"object"}}},"description":"Unknown metaproperty or metaproperty option"}},"summary":"Retrieve dependencies for a metaproperty option","tags":["Option dependency (Please use new Automations API if possible)"]}},"/api/v4/metaproperties/{id}/options/{optionId}/dependencies/group":{"post":{"description":"Create a dependency group for a metaproperty option.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"optionId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"data":{"description":"JSON-serialised list of dependency option ids.","example":["00000000-0000-0000-0000000000000000","00000000-0000-0000-0000000000000000"],"items":{"type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"examples":{"example-201":{"value":{"id":"00000000-0000-0000-0000000000000000","message":"Created","statuscode":201}}}}},"description":"Created"},"400":{"content":{"application/json":{"examples":{"example-data-cannot-be-empty":{"value":{"message":"Data cannot be empty","statuscode":"400"}},"example-invalid-metaproperty-id":{"value":{"message":"Invalid metaproperty ID","statuscode":"400"}},"example-no-data-sent":{"value":{"message":"No data sent","statuscode":"400"}},"example-unknown-metaproperty-option-id":{"value":{"message":"Unknown metaproperty option id","statuscode":"400"}}}}},"description":"Bad Request"},"404":{"content":{"application/json":{"examples":{"example-unknown-dependency-option":{"value":{"message":"Unknown dependency option","statuscode":"404"}}}}},"description":"Not Found"}},"summary":"Create dependency group","tags":["Option dependency group (Please use new Automations API if possible)"]}},"/api/v4/metaproperties/{id}/options/{optionId}/dependencies/group/{groupId}":{"post":{"description":"Modify a dependency group for a metaproperty option.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"optionId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"groupId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"data":{"description":"JSON-serialised string of dependency (metaproperty option) ids.","example":["00000000-0000-0000-0000000000000000","00000000-0000-0000-0000000000000000"],"items":{"type":"string"},"type":"array"},"groupId":{"description":"The id of the dependency group you’d like to modify.","example":"00000000-0000-0000-0000000000000000","type":"string"},"id":{"description":"The id of the metaproperty the (metaproperty) option belongs to.","example":"00000000-0000-0000-0000000000000000","type":"string"},"optionId":{"description":"The id of the (metaproperty) option the dependency group belongs to.","example":"00000000-0000-0000-0000000000000000","type":"string"}},"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"examples":{"example-201":{"value":{"message":"Created","statuscode":201}}}}},"description":"Created"},"404":{"content":{"application/json":{"examples":{"example-unknown-group":{"value":{"message":"Unknown group","statuscode":"404"}},"example-unknown-metaproperty-option":{"value":{"message":"Unknown metaproperty option","statuscode":"404"}}}}},"description":"Not Found"}},"summary":"Modify dependency group","tags":["Option dependency group (Please use new Automations API if possible)"]}},"/api/v4/metaproperties/{id}/options/{optionId}/dependencies/group/{groupId}/{dependencyId}":{"delete":{"description":"Remove a dependency option from a specific dependency group for a metaproperty option.","parameters":[{"description":"The id of the metaproperty the (metaproperty) option belongs to.","in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"description":"The id of the (metaproperty) option the dependency group belongs to.","in":"path","name":"optionId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"description":"The id of the dependency group you’d like to remove a dependency from.","in":"path","name":"groupId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"description":"The id of the dependency (metaproperty option) you’d like to remove from the dependency group.","in":"path","name":"dependencyId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"responses":{"204":{"description":"No Content"},"404":{"content":{"application/json":{"examples":{"example-unknown-dependency-option":{"value":{"message":"Unknown dependency option","statuscode":"404"}},"example-unknown-group":{"value":{"message":"Unknown group","statuscode":"404"}},"example-unknown-metaproperty":{"value":{"message":"Unknown metaproperty","statuscode":"404"}},"example-unknown-metaproperty-option":{"value":{"message":"Unknown metaproperty option","statuscode":"404"}}},"schema":{"properties":{"message":{"example":"Unknown metaproperty","type":"string"},"statuscode":{"example":"404","type":"string"}},"type":"object"}}},"description":"Not Found"}},"summary":"Remove a dependency option from a group","tags":["Option dependency group (Please use new Automations API if possible)"]},"post":{"description":"Add a dependency option to a specific dependency group for a metaproperty option.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"optionId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"groupId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"dependencyId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"dependencyId":{"description":"The id of the dependency (metaproperty option) you’d like to add to the dependency group.","example":"00000000-0000-0000-0000000000000000","type":"string"},"groupId":{"description":"The id of the dependency group you’d like to add a dependency to.","example":"00000000-0000-0000-0000000000000000","type":"string"},"id":{"description":"The id of the metaproperty the (metaproperty) option belongs to.","example":"00000000-0000-0000-0000000000000000","type":"string"},"optionId":{"description":"The id of the (metaproperty) option the dependency group belongs to.","example":"00000000-0000-0000-0000000000000000","type":"string"}},"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"examples":{"example-201":{"value":{"message":"Created","statuscode":201}}}}},"description":"Created"},"404":{"content":{"application/json":{"examples":{"example-unknown-dependency-option":{"value":{"message":"Unknown dependency option","statuscode":"404"}},"example-unknown-group":{"value":{"message":"Unknown group","statuscode":"404"}},"example-unknown-metaproperty":{"value":{"message":"Unknown metaproperty","statuscode":"404"}},"example-unknown-metaproperty-option":{"value":{"message":"Unknown metaproperty option","statuscode":"404"}}}}},"description":"Not Found"}},"summary":"Add a dependency option to a group","tags":["Option dependency group (Please use new Automations API if possible)"]}},"/api/v4/metaproperties/{id}/options/{optionId}/dependencies/{dependencyId}":{"delete":{"description":"Delete a dependency from a metaproperty option.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"optionId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"dependencyId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"responses":{"204":{"description":"No Content"},"404":{"content":{"application/json":{"examples":{"example-unknown-dependency-option":{"value":{"message":"Unknown dependency option","statuscode":404}},"example-unknown-metaproperty":{"value":{"message":"Unknown metaproperty","statuscode":404}},"example-unknown-metaproperty-option":{"value":{"message":"Unknown metaproperty option","statuscode":404}}},"schema":{"properties":{"message":{"example":"Unknown metaproperty","type":"string"},"statuscode":{"example":"404","type":"string"}},"type":"object"}}},"description":"Not Found"}},"summary":"Delete a dependency","tags":["Option dependency (Please use new Automations API if possible)"]},"post":{"description":"Manage metaproperty option dependencies","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"optionId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"path","name":"dependencyId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":false},"responses":{"201":{"content":{"application/json":{"examples":{"example-201":{"value":{"message":"Created","statuscode":201}}}}},"description":"Created"},"404":{"content":{"application/json":{"examples":{"example-unknown-dependency-option":{"value":{"message":"Unknown dependency option","statuscode":404}},"example-unknown-metaproperty":{"value":{"message":"Unknown metaproperty","statuscode":404}},"example-unknown-metaproperty-option":{"value":{"message":"Unknown metaproperty option","statuscode":404}}}}},"description":"Not Found"}},"summary":"Add a dependency","tags":["Option dependency (Please use new Automations API if possible)"]}}},"security":[{"OAuth2":["METAPROPERTYMANAGEMENT","METAMANAGEMENT"]},{"permanentToken":["METAPROPERTYMANAGEMENT","METAMANAGEMENT"]}],"servers":[{"url":"https://{your-bynder-domain}/"}],"tags":[{"name":"Option dependency (Please use new Automations API if possible)"},{"name":"Option dependency group (Please use new Automations API if possible)"}]}
```