Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Upsert tags relationships

Bulk-upserts tag relationships to a product, variant or variant group. Each item names the target with item_id plus item_type (product, variant or variant_group).

PUT/api/v2/{team_slug}/{app_slug}/tags/relationships
Authorization
AuthorizationBearer token · headerrequired

Management API token, sent as Authorization: Bearer <token>.

Path parameters
team_slugstringrequired
app_slugstringrequired
Request body
requiredapplication/json
relationshipsUpsertTagRelationshipItem[]required
min items 1 · max items 20
Show properties
Array of UpsertTagRelationshipItem
tag_idUUIDrequired
item_idUUIDrequired
item_typeTagRelationshipItemTyperequired
Allowed:productvariantvariant_group
orderinteger
Responses
200

OK (partial success possible)

dataTagRelationship[]required
Show properties
Array of TagRelationship
tag_idUUIDrequired
item_idUUIDrequired
item_typeTagRelationshipItemTyperequired
Allowed:productvariantvariant_group
orderinteger
errorsTagRelationshipError[]required
Show properties
Array of TagRelationshipError
tag_idUUID
item_idUUID | null
Show properties
Any of:
UUID
string<uuid>
null
null
item_typeTagRelationshipItemType | null
Show properties
Any of:
TagRelationshipItemType
string
null
null
messagestringrequired
400

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
401

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
403

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
500

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X PUT 'https://api.enad.io/api/v2/string/string/tags/relationships' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "relationships": [
    {
      "tag_id": "39c8a0b3-fbe8-4801-95bf-e8a0792edf1d",
      "item_id": "4d8cd62e-a579-4dae-af8c-3172f96f8f7c",
      "item_type": "product",
      "order": 0
    }
  ]
}'
Response
{
  "data": [
    {
      "tag_id": "39c8a0b3-fbe8-4801-95bf-e8a0792edf1d",
      "item_id": "4d8cd62e-a579-4dae-af8c-3172f96f8f7c",
      "item_type": "product",
      "order": 0
    }
  ],
  "errors": [
    {
      "tag_id": "39c8a0b3-fbe8-4801-95bf-e8a0792edf1d",
      "item_id": "4d8cd62e-a579-4dae-af8c-3172f96f8f7c",
      "item_type": "product",
      "message": "string"
    }
  ]
}