Skip to content

Remove handles from the default exclusion list

Request

Removes handles from the platform's default exclusion list. Returns the updated list object. This operation is free — it does not consume credits.

Security
Bearer
Path
platformstringrequired

The social media platform the exclusion list applies to.

Enum:"instagram""youtube""tiktok""twitch""twitter""onlyfans"
Bodyrequired
handlesArray of stringsrequired

Handles to add to or remove from the list. Normalized automatically (lowercased, @ stripped, URLs parsed to extract the handle).

curl -i -X DELETE \
  'https://api-dashboard.influencers.club/public/v1/discovery/exclusion-lists/default/{platform}/entries/' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "handles": [
      "string"
    ]
  }'

Responses

Bodyapplication/json
idintegerrequired

The exclusion list's unique identifier.

Example:42
namestringrequired

Human-readable name of the exclusion list.

Example:"Blocklist Q4"
platformstringrequired

The social media platform this list applies to.

Example:"instagram"
is_defaultbooleanrequired

Whether this is the team's default list for the platform.

Example:false
handle_countintegerrequired

Number of handles currently in the list.

Example:3
created_atstring, (date-time)required

When the list was created.

Example:"2026-01-15T09:30:00Z"
updated_atstring, (date-time)required

When the list was last modified.

Example:"2026-01-20T14:05:00Z"
Response
{ "id": 42, "name": "Blocklist Q4", "platform": "instagram", "is_default": false, "handle_count": 3, "created_at": "2026-01-15T09:30:00Z", "updated_at": "2026-01-20T14:05:00Z" }