---
title: "Tags API"
url: "https://earlyaccess.developers.bynder.com/apis/tags-api-1/versions/411a7676-6c40-4709-95db-41fe46354636"
---

# Tags API

OpenAPI specification document.

```json
{"components":{"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://{your-auth-url}","scopes":{"MEDIAAUDIT":"","MEDIAEDIT":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"},"clientCredentials":{"scopes":{"MEDIAAUDIT":"","MEDIAEDIT":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"}},"type":"oauth2"},"permanentToken":{"in":"header","name":"Authorization","type":"apiKey"}}},"info":{"title":"Tags API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v4/tags":{"get":{"description":"Retrieve a list of tags.","parameters":[{"in":"query","name":"limit","schema":{"default":50,"maximum":1000,"type":"integer"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"orderBy","schema":{"enum":["tag asc","tag desc","mediaCount desc"],"type":"string"}},{"in":"query","name":"keyword","schema":{"type":"string"}},{"in":"query","name":"mincount","schema":{"default":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example1":{"value":[{"id":"00000000-0000-0000-0000000000000000","mediaCount":12,"tag":"Landscape"},{"id":"00000000-0000-0000-0000000000000001","mediaCount":82,"tag":"Amsterdam"}]}},"schema":{"items":{"properties":{"id":{"example":"00000000-0000-0000-0000000000000000","type":"string"},"mediaCount":{"example":12,"type":"integer"},"tag":{"example":"Landscape","type":"string"}},"type":"object"},"type":"array"}}},"description":"A list of tags."},"400":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"`keyword` and `mincount` is not a valid combination","type":"string"},"statuscode":{"example":400,"type":"integer"}},"type":"object"}}},"description":"Invalid request parameters."}},"security":[{"OAuth2":[]},{"permanentToken":[]}],"summary":"Retrieve tags","tags":["Tags"]}},"/api/v4/tags/{id}/media":{"delete":{"description":"Remove a tag from a list of assets.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"in":"query","name":"deleteIds","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000,00000000-0000-0000-0000000000000000","type":"string"}}],"responses":{"204":{"description":"No Content"},"404":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"Media 00000000-0000-0000-0000000000000000 not found","type":"string"},"statuscode":{"example":404,"type":"integer"}},"type":"object"}}},"description":"Media not found"}},"security":[{"OAuth2":["MEDIAEDIT","MEDIAAUDIT"]},{"permanentToken":["MEDIAEDIT","MEDIAAUDIT"]}],"summary":"Remove tag from assets","tags":["Tags"]},"post":{"description":"Add a tag to a list of assets.","parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"data":{"items":{"example":"00000000-0000-0000-0000000000000000","type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"Accepted","type":"string"},"statuscode":{"example":202,"type":"integer"}},"type":"object"}}},"description":"Accepted"},"404":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"Media 00000000-0000-0000-0000000000000000 not found","type":"string"},"statuscode":{"example":404,"type":"integer"}},"type":"object"}}},"description":"Media not found"}},"security":[{"OAuth2":["MEDIAEDIT","MEDIAAUDIT"]},{"permanentToken":["MEDIAEDIT","MEDIAAUDIT"]}],"summary":"Add tag to assets","tags":["Tags"]}}},"servers":[{"url":"https://{your-bynder-domain}/"}],"tags":[{"description":"","name":"Tags"}]}
```