Site tags

Site tag endpoints let you manage and customize tags on your Productsup sites. Tags provide a flexible way to identify and reference sites using your own key-value pairs.

List

Use a GET request to list all tags for a site or retrieve a specific tag by its ID.

List all tags for a site

GET https://platform-api.productsup.io/platform/v2/sites/<siteId>/tags

curl --location 'https://platform-api.productsup.io/platform/v2/sites/<SITE_ID>/tags' \
--header 'X-Auth-Token: TOKEN'

Field	Type	Description
`siteId`	integer	Site to list tags for

Get a tag by its identifier

GET https://platform-api.productsup.io/platform/v2/sites/<siteId>/tags/<tagId>

curl --location 'https://platform-api.productsup.io/platform/v2/sites/<SITE_ID>/tags/<TAG_ID>' \
--header 'X-Auth-Token: TOKEN'

Field	Type	Description
`siteId`	integer	Site the tag belongs to
`tagId`	integer	Tag to retrieve

Create

Use a POST request to create a new tag for a site.

POST https://platform-api.productsup.io/platform/v2/sites/<siteId>/tags

curl --location 'https://platform-api.productsup.io/platform/v2/sites/<SITE_ID>/tags' \
--header 'X-Auth-Token: TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "site_id": "<SITE_ID>",
  "key": "<TAG_KEY>",
  "value": "<TAG_VALUE>",
  "readonly": 0
}'

Request body fields

Field	Type	Description
`site_id`	string	Site the tag belongs to
`key`	string	Name of the tag
`value`	string	Value of the tag
`readonly`	integer	Set to `1` to prevent end users from editing this tag in the platform UI

A tag's key must be unique per site. Creating a tag with a key that already exists for that site returns an error.

Delete

Use a DELETE request to remove a tag from a site.

DELETE https://platform-api.productsup.io/platform/v2/sites/<siteId>/tags/<tagId>

curl --location --request DELETE 'https://platform-api.productsup.io/platform/v2/sites/<SITE_ID>/tags/<TAG_ID>' \
--header 'X-Auth-Token: TOKEN'

Field	Type	Description
`siteId`	integer	Site the tag belongs to
`tagId`	integer	Tag to delete