TEASEDocs
ProductsClubHow-to

Reclaim a free-pool slot

Pull a link out of active routing and return it to the spare pool instead of retiring it.

Who this is for: a workspace owner.

Dropping a country — or any (domain, country, arm) slot you no longer route to — doesn't have to throw the link away. Reclaiming recycles it back into the free pool so a later dress can reuse it elsewhere.

curl -X POST https://app.tease.link/api/admin/free-pool/reclaim \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "yourdomain.com", "country": "DE", "arm": "ftl" }'
{ "reclaimed": true, "returned_to_pool": true, "clones_reclaimed": 0,
  "provider_id": "pv_881", "domain": "yourdomain.com", "country": "DE", "arm": "ftl" }
FieldTypeRequiredDescription
domainstringyesMust already be registered.
countrystringnoISO code; empty = the arm-wide default slot.
armstringnopaid or ftl. Defaults to paid.

An unknown slot answers 404 slot_not_found. returned_to_pool is false when the slot had no real OnlyFans link behind it to begin with (a shared-pool fallback row, or one already recycled) — the routing row is still removed either way. If a trial-split clone had been riding the same slot, it's reclaimed too and counted in clones_reclaimed, so the whole slot is cleared in one call rather than leaving an orphaned clone still routing traffic.

Recycled, not retired

Reclaim only touches of_campaigns visibility/layout keys and TEASE's own segment_links / source_link rows — fan_link and of_transactions are never touched. The link goes back into the pool exactly as it was, ready for the next dress.

What's next

Reclaiming is a recycle, not a delete — the underlying trial/tracking link still exists, just hidden. If the actual goal is removing that link for good, check what breaks first: deleting is not reversible the way reclaiming is.

On this page