Fans

Delete a fan tag

DELETE/v1/tags/{tag_id}

Deletes the tag from the agency catalog and removes it from every fan that carries it.

Required scopewrite:tags

Rate limit20 requests per minute

curl -X DELETE 'https://api.fansquare.so/v1/tags/58368a92-838b-4cb0-ab37-d54ce826ea11' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "type": "https://developers.offmy.co/errors/validation_failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "limit: Number must be less than or equal to 200",
  "instance": "/v1/tags/12345",
  "errors": [
    {
      "keyword": "invalid_string",
      "instancePath": "/tag_id",
      "schemaPath": "#/tag_id/invalid_string",
      "params": {
        "issue": {
          "code": "invalid_string",
          "validation": "uuid",
          "path": [
            "tag_id"
          ],
          "message": "Invalid uuid"
        }
      },
      "message": "Invalid uuid",
      "path": "tag_id"
    }
  ]
}

Parameters

Headers

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

Path

tag_idstringrequired
Fansquare tag id, from GET /v1/tags.
format uuid

Response

No content

No response body

curl -X DELETE 'https://api.fansquare.so/v1/tags/58368a92-838b-4cb0-ab37-d54ce826ea11' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "type": "https://developers.offmy.co/errors/validation_failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "limit: Number must be less than or equal to 200",
  "instance": "/v1/tags/12345",
  "errors": [
    {
      "keyword": "invalid_string",
      "instancePath": "/tag_id",
      "schemaPath": "#/tag_id/invalid_string",
      "params": {
        "issue": {
          "code": "invalid_string",
          "validation": "uuid",
          "path": [
            "tag_id"
          ],
          "message": "Invalid uuid"
        }
      },
      "message": "Invalid uuid",
      "path": "tag_id"
    }
  ]
}