# Bot Code Transfer System (A-Z)

> Securely transfer bot source code and architecture between Botlify users with automatic credential sanitization.

**Category:** REST API Reference  
**URL:** https://docs.botlify.cloud/api-transfers  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

## How Bot Transfer Works

   

The Bot Transfer Engine allows developers to clone and transfer bot projects to clients or other developers safely. Sensitive credentials (`.env` tokens and live `database.db`) are automatically sanitized and kept private.

   

## 1. Create Transfer Offer (create_transfer)

   

Action: `create_transfer`
   Parameters: `bot_id`, `target_recipient` (Telegram `@username` or numeric ID)

   
```php
curl -X POST https://botlify.cloud/api/v1   -H "X-API-KEY: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "action": "create_transfer",
    "bot_id": 14,
    "target_recipient": "@client_username"
  }'
```

   

Returns a secure 72-hour transfer code: `{"ok": true, "transfer_code": "TR-14-8F92A1BC"}`.

   

## 2. List Pending Transfers (list_transfers)

   

Action: `list_transfers` or `transfers`
   Returns incoming offers awaiting your acceptance as well as outgoing offers you created.

   

## 3. Inspect Transfer Details (get_transfer)

   

Action: `get_transfer`
   Parameters: `transfer_code`
   Returns the bot display name, code file count, sender handle, and expiration timestamp.

   

## 4. Accept Bot Transfer (accept_transfer)

   

Action: `accept_transfer`
   Parameters:

   
    
- transfer_code: The transfer verification code (e.g. TR-14-8F92A1BC).

    
- token: Recipient's new Telegram BotFather token.

    
- admin_chat_id (optional): Recipient's admin chat ID.

   
   
```php
curl -X POST https://botlify.cloud/api/v1   -H "X-API-KEY: RECIPIENT_API_KEY"   -H "Content-Type: application/json"   -d '{
    "action": "accept_transfer",
    "transfer_code": "TR-14-8F92A1BC",
    "token": "7987654321:AAHnew_recipient_token..."
  }'
```

   

## 5. Reject Bot Transfer (reject_transfer)

   

Action: `reject_transfer`
   Parameters: `transfer_id` (Numeric ID from `list_transfers`).