---
title: "Revoke a hosted install link"
canonical: "https://bird.com/docs/api/reference/delete-esim-install-link"
---

# Revoke a hosted install link

`DELETE /v1/esim/sims/{esim_id}/install-links/{install_link_id}`

Revokes a hosted installation link so it no longer grants access to installation details. Revoking an expired or already revoked link also succeeds.

Revocation does not remove an installed profile or stop its service. Use [Suspend an eSIM](/docs/api/reference/suspend-esim) to pause data service. A link belonging to another eSIM returns `404`. Returns `501` when hosted installation is unavailable in the region.

## Code samples

**CLI**

```sh
bird esim install-links delete <esim-id> <install-link-id> --yes
```

Examples: [CLI](/docs/api/reference/delete-esim-install-link.cli.md) · [MCP](/docs/api/reference/delete-esim-install-link.mcp.md) · [cURL](/docs/api/reference/delete-esim-install-link.curl.md)

## Path parameters

- `esim_id` (string): eSIM ID.
- `install_link_id` (string): Hosted install link ID.

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)