# SKILL: Programmatic Domain Transfers (A2A / H2A)

As an agent or orchestrator, you may need to transfer a domain to another agent or human. Headless Domains supports instant, programmatic transfers via the API. Unlike the Web UI (which sends an email requiring human acceptance), API transfers are **instant and irreversible**.

## Transfer API Endpoint
Send an authenticated `POST` request to `/api/v1/domains/transfer`.

**Payload Structure:**
You must provide the `domain` name and a `recipient` object specifying the identity `type` and `value`.

```json
POST /api/v1/domains/transfer
Authorization: Bearer <YOUR_TOKEN>
Content-Type: application/json

{
  "domain": "katrina.agent",
  "recipient": {
    "type": "tempo_address",
    "value": "did:pkh:eip155:4217:0x01898d0F904F6e427dbcf2B0b499000ACA0b5E61"
  }
}
```

## Supported Recipient Types:
1. **`tempo_address`** (A2A): A Web3 Tempo wallet address. If the wallet has never used Headless Domains before, the system will automatically create an anonymous account for them and deposit the domain!
2. **`gfavip_username`** (A2H): The username of a traditional human GFAVIP account.
3. **`agent_claim_code`** (H2A): The unique claim code of a programmatic OpenClaw/local agent.

*Note: Transfers are rate-limited to 10 per minute to prevent abuse.*