Tags
Labels the account makes for its websites, documents and tasks, to group and filter them.
A tag is a label the account makes, such as "Competitor" or "Pre-production", and puts on things to group and filter them, in Silktide and in reports. Silktide 5 calls them labels; the API keeps the name tags, so tagId and tagIds are the same labels people see.
Each tag is for one kind of thing, its entityType:
entityType | Goes on |
|---|---|
section | Websites and their sections. |
document | Documents. |
task | Tasks. |
Tags of different types never mix: a website tag and a task label can share a name and still be two tags. A tag can belong to a tag group, such as "Region", so related tags are shown together.
These operations create, change and delete the tags themselves. To put tags on a website, send their ids as tagIds to Update a website; Tag websites walks through it.
In Silktide itself: Labels screen, in Help.
- GETList the account's tags
/v1/tagsReturns every tag in the account, sorted by label, with how many things each one is on. - POSTCreate one or more tags
/v1/tagsCreates tags. - PUTUpdate a tag
/v1/tags/{tagId}Changes a tag's label, color or group. - DELDelete a tag and remove it everywhere
/v1/tags/{tagId}Deletes a tag at once and takes it off everything it was on.