Add a Tag - Alfresco Content Services - 23.4 - 23.4 - Ready - Alfresco - external

You can add tags to both folders and files. This is part of the collaboration features that exists around nodes. There is also like/unlike and commenting on nodes.

Tags are added to nodes with the following POST call: http://localhost:8080/alfresco/api/-default-/public/alfresco/versions/1/nodes/{id}/tags

The Node Identifier for the folder or file node to add the tag to is specified with the {id} parameter. Then a POST body is created with the comment as follows:

{   
  "tag": "project-x" 
}

It’s possible to add more than one tag at a time as follows:

[
    {
     "tag": "project-x"
    },
    {
     "tag": "meeting"
    }
]

Let’s look at an example of how to add a tag to a file (it would be done in the same way for a folder).

Let’s assume we have a file with the 7279b5c5-da55-4e98-8b12-72d33b90c810 Node Identifier, the call would then look like this:

$ curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Authorization: Basic VElDS0VUXzA4ZWI3ZTJlMmMxNzk2NGNhNTFmMGYzMzE4NmNjMmZjOWQ1NmQ1OTM=' -d '{ "tag": "project-x" }' 'http://localhost:8080/alfresco/api/-default-/public/alfresco/versions/1/nodes/7279b5c5-da55-4e98-8b12-72d33b90c810/tags'  | jq
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100    95    0    73  100    22    182     55 --:--:-- --:--:-- --:--:-* 238
{
  "entry": {
    "tag": "project-x",
    "id": "a427120f-a679-43e6-bcc5-4b0be1f91ea3"
  }
}

The response contains the tag identifier (i.e. id) together with the tag we just added to the node.