Meaning of entityId in /tags endpoint?

[Cojohnny97]

What is the meaning of the entityId of a tag object? I'm not sure because the /tags endpoint is hardly documented.
Is it the first entity object, this tag was assigned to? Because I tested to add the tag to other entities and nothing changed with the entityId. Shouldn't it rather be an array of all entity Ids, this tag is assigned to or am I missing something here?

[nilzzzzzz]

Hi @Cojohnny97 ,

the entity id is the id of the entity you want to get the tags for. Example: tasks/{taskId}/tags to get the tags of the task with the specified id. Or projects/{projectId}/tags.

Does that answer your question? Can you be a bit more specific which documentation is missing? I can see comments and descriptions on all the endpoints.

Best

Nils

[Cojohnny97]

I mean that the reponse body is undocumented. For example: tasks/tags returns all tags but multiple used tags still just have one entityId in the response. Do you get what I mean?

[nilzzzzzz]

Thanks! We will fix the docs & the response. You can for now just ignore the entity id.. Will be removed. The endpoint returns all tag values which have been used in awork for the defined entity name (in this example tasks).