Managing Tags

Tags label cards for filtering and organization, and every tag lives in a tag category. The endpoints below create and update tags; to manage the categories themselves, see Tag Categories.

In every endpoint, teamId is the ID of the team, in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Along with your authentication, requests with a body require a Content-Type: application/json header.

Create a tag

Add a tag

Two fields are required:

Field	Description
`value`	The name of the tag. Required.
`categoryId`	The ID of the category that will contain the tag. Required.

Request

curl -X POST https://api.getguru.com/api/v1/teams/{teamId}/tagcategories/tags \
  -u $GURU_USER:$GURU_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "categoryId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "value": "My Tag"
  }'

Response

The value and categoryId you sent, along with the id of the tag that was created:

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "categoryId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "value": "My Tag"
}

Update a tag

tagId in the URL is the ID of the tag to update. Two fields are required:

Field	Description
`value`	The name of the tag. Required.
`categoryId`	The ID of the category that will contain the tag. Required. Change it to move the tag to another category.

Request

curl -X PUT https://api.getguru.com/api/v1/teams/{teamId}/tagcategories/tags/{tagId} \
  -u $GURU_USER:$GURU_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "categoryId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "value": "My Updated Tag"
  }'

Response

The id, value, and categoryId of the tag that was updated:

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "categoryId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "value": "My Updated Tag"
}