# restore_domain

> Restore an expired domain from the registry redemption / pending-delete period.

- Tier: D
- Required scope: write:billing + write:domains
- Annotations: destructiveHint
- Docs: https://api.inleed.com/tools/restore-domain

## Description

Restore an expired domain from the registry redemption / pending-delete period. This costs money (a steep redemption fee) and is irreversible, so it does not restore on this call: it validates ownership and returns `{status:"confirmation_required", confirmationUrl, expiresAt, preview}`. Show the human the `confirmationUrl`; on approval a redemption quote is returned. Do not approve it yourself.

## Input schema

- `input` — string (required). A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved target is echoed back in the response.
- `years` — integer. How many years to add on restore (1–10), where the registry bills the restore as a renewal. Omit for the registry default.
- `attempt_key` — string. An idempotency key you choose. Reusing it within an hour returns the same held restore instead of creating a second one.

## Example call

```json
{
  "name": "restore_domain",
  "arguments": {
    "input": "example.se"
  }
}
```