Fans

Remove a tag from fans in bulk

POST/v1/accounts/{account_id}/tags/{tag_id}/remove

Removes this tag from every fan of the batch, in a single call. Fans that do not carry the tag are ignored, so the count returned may be lower than the number of ids sent.

Required scopewrite:tags

Rate limit120 requests per minute

curl -X POST 'https://api.fansquare.so/v1/accounts/c851d9d6-b90b-4958-aed2-2fdaa2fe21a3/tags/58368a92-838b-4cb0-ab37-d54ce826ea11/remove' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste" \
  -H "Content-Type: application/json" \
  -d '{
  "fan_ids": [
    "a6df8022-e509-4575-ad28-e29c2d1d42dc"
  ]
}'

{
  "removed": 1
}

Parameters

Headers

Fansquare-Versionstringrequired
API version to pin. Accepts the mineral name or the release date of a version.

Path

account_idstringrequired
MYM account id (account.external_id in GET /v1/creators).
min length 1
tag_idstringrequired
Fansquare tag id, from GET /v1/tags.
format uuid

Body

application/json

fan_idsarray of stringsrequired
MYM fan ids. 1 to 500 per call; duplicates are ignored.
format uuidmin items 1max items 500

Response

OK, application/json

removedintegerrequired
Number of fans the tag was actually removed from (may be lower than the ids sent).

curl -X POST 'https://api.fansquare.so/v1/accounts/c851d9d6-b90b-4958-aed2-2fdaa2fe21a3/tags/58368a92-838b-4cb0-ab37-d54ce826ea11/remove' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste" \
  -H "Content-Type: application/json" \
  -d '{
  "fan_ids": [
    "a6df8022-e509-4575-ad28-e29c2d1d42dc"
  ]
}'

{
  "removed": 1
}