Fans

Unassign a fan

DELETE/v1/accounts/{account_id}/fans/{fan_id}/assignment

Removes the assignment of the fan. Deleting an assignment that does not exist also returns 204.

Required scopewrite:assignments

Rate limit60 requests per minute

curl -X DELETE 'https://api.fansquare.so/v1/accounts/c851d9d6-b90b-4958-aed2-2fdaa2fe21a3/fans/a6df8022-e509-4575-ad28-e29c2d1d42dc/assignment' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "type": "https://developers.offmy.co/errors/validation_failed",
  "title": "Validation failed",
  "status": 400,
  "instance": "/v1/accounts/c851d9d6-b90b-4958-aed2-2fdaa2fe21a3/fans/12345/assignment",
  "errors": [
    {
      "keyword": "invalid_string",
      "instancePath": "/fan_id",
      "schemaPath": "#/fan_id/invalid_string",
      "params": {
        "issue": {
          "code": "invalid_string",
          "validation": "uuid",
          "path": [
            "fan_id"
          ],
          "message": "Invalid uuid"
        }
      },
      "message": "Invalid uuid",
      "path": "fan_id"
    }
  ]
}

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
fan_idstringrequired
MYM fan id.
format uuid

Response

No content

No response body

curl -X DELETE 'https://api.fansquare.so/v1/accounts/c851d9d6-b90b-4958-aed2-2fdaa2fe21a3/fans/a6df8022-e509-4575-ad28-e29c2d1d42dc/assignment' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "type": "https://developers.offmy.co/errors/validation_failed",
  "title": "Validation failed",
  "status": 400,
  "instance": "/v1/accounts/c851d9d6-b90b-4958-aed2-2fdaa2fe21a3/fans/12345/assignment",
  "errors": [
    {
      "keyword": "invalid_string",
      "instancePath": "/fan_id",
      "schemaPath": "#/fan_id/invalid_string",
      "params": {
        "issue": {
          "code": "invalid_string",
          "validation": "uuid",
          "path": [
            "fan_id"
          ],
          "message": "Invalid uuid"
        }
      },
      "message": "Invalid uuid",
      "path": "fan_id"
    }
  ]
}