# set_domain_transfer_lock

Source: https://modulify.ai/docs/api/bought-domains/set-domain-transfer-lock

Turns the transfer lock of a domain the workspace bought on or off.

- Title: Lock or unlock a bought domain for transfers
- Scope: `domains:write`
- Access: Destructive
- Endpoint: `POST /v1/set_domain_transfer_lock`

The lock keeps the domain from being moved to another registrar. Anyone holding its transfer code can move an unlocked domain, so the tool tells the client to confirm with you before unlocking, and to unlock only while you are moving the domain away. Unlocking is refused while the registrar keeps its own lock on the domain, until `TransferLockExpires_At` in `get_bought_domain`.

The answer is the domain as `get_bought_domain` reads it. Only the workspace owner can do this, and the domain must be `active` or `expiring`. The workspace can make 30 domain changes a minute, shared with the **Domains** page and covering DNS records, nameservers, the registrant, the transfer lock, auto-renew and transfer codes, and a refusal says how long to wait. See [Transfer lock](https://modulify.ai/docs/publish/buy-a-domain#transfer-lock).

## Request

Call it with a `POST` to `https://api.modulify.ai/v1/set_domain_transfer_lock`, sending the inputs below as a JSON object. The token needs the `domains:write` scope.

> **Warning**
>
> This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an [Idempotency-Key](https://modulify.ai/docs/api/idempotency) header whenever you might retry it.

```bash
curl -X POST https://api.modulify.ai/v1/set_domain_transfer_lock \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"WORKSPACE_ID","domainId":"DOMAIN_ID","locked":true}'
```

Over MCP, the same method is the [set_domain_transfer_lock tool](https://modulify.ai/docs/mcp/bought-domains/set-domain-transfer-lock).

## Inputs

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `workspaceId` | string | Yes | The workspace that owns the domain. |
| `domainId` | string | Yes | The `_id` of the bought domain, from `list_bought_domains`. |
| `locked` | boolean | Yes | True locks the domain against transfers, false unlocks it. |

## Response

Every call answers with the [JSON envelope](https://modulify.ai/docs/api/requests-and-responses#the-response) of `success`, `message`, `data`, `code` and `version`. `data` holds the result described above, and on a method that returns a total, `count` carries it. The [response headers](https://modulify.ai/docs/api/requests-and-responses#headers-on-every-method-call) carry the call's `X-Request-Id` and what is left of your per-minute budget in `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`. [Errors](https://modulify.ai/docs/api/errors) explains every status code a call can answer with.