addTag #

Adds a tag to one or several assets

Query Syntax #

HTTP #

 Copied to clipboard!
URL: http://kuzzle:7512/_plugin/cloudinary/tags/<tag>
Method: POST
Body: 

 Copied to clipboard!
{
  "public_id" : "sample", 
  "tag" : "<tag_to_add>"
}

Other protocols #

If you want to add a tag to only one asset you can use this query :

 Copied to clipboard!
{
  "controller": "cloudinary/tags",
  "action": "addTag",

	"body": { 
    "public_id" : "sample", 
    "tag" : "<tag_to_add>"
  }
}

If you want to add a tag to several assets you can use this query :

 Copied to clipboard!
{
  "controller": "cloudinary/tags",
  "action": "addTag",

	"public_id" : [ "sample", "sample2" ], 
	"tag" : "<tag_to_add>"
}

Arguments #

public_id: (String or Array of string) public_id of the asset
tag: Tag to add to the specified asset

Response #

 Copied to clipboard!
{
  "status": 200,
  "error": null,
  "controller": "cloudinary/tags",
  "action": "addTag",
  "requestId": "<unique request identifier>",
  "result": {
    "public_ids": [
      "sample",
      "sample2"
    ] 
  }
}

If one or several assets haven't been updated, a 206 Partial Error will be throw with a detail of the error for each asset

Possible Errors #

Edit this page on Github