> For the complete documentation index, see [llms.txt](https://en-api.decisiontele.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://en-api.decisiontele.com/esim-api/release-an-esim.md).

# Release an eSIM

Unassign an eSIM from a client and make it available for future allocation.

Use this operation when an eSIM needs to be removed from the current client and returned to the pool of available eSIMs.

#### Request

PATCH /api/v1/esims/transfer

```
curl --location --request PATCH \
"https://esim-api.it-decision.com/api/v1/esims/transfer" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <TOKEN>" \
--data '{
  "esims": [
    "<ESIM_ID>"
  ],
  "clientId": null
}'
```

#### Result

The eSIM is unassigned from the current client and becomes available for future allocation.

{% hint style="info" %}
Setting clientId to null releases the eSIM from the client without deleting the eSIM itself.
{% endhint %}