> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spinnable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfer Worker Ownership

> Hand off a worker to another Spinnable user while preserving their memory, skills, and conversations

## What Is Worker Transfer?

Worker transfer lets you hand over full ownership of a worker to another Spinnable user. The new owner becomes the worker's manager — responsible for configuration, tool connections, and billing — while all the worker's memory, conversations, skills, and settings carry over intact.

This is useful when:

* A team member is taking over responsibility for a worker's domain
* You're leaving a role and need to pass your worker to a successor
* A worker was set up for testing and now needs to go to its permanent owner
* Responsibilities shift within your organization

<Note>
  Only the worker's **owner** (manager) can initiate a transfer. Co-managers cannot transfer workers they don't own.
</Note>

## What Gets Preserved

When a transfer is accepted, the worker keeps:

| Preserved                  | Details                                               |
| -------------------------- | ----------------------------------------------------- |
| ✅ Profile & settings       | Name, avatar, job policy, behavior configuration      |
| ✅ Conversations & messages | Full chat history across all channels                 |
| ✅ Memory & knowledge base  | Everything the worker has learned                     |
| ✅ Skills                   | All learned skills, scripts, and resources            |
| ✅ Organization memberships | Worker stays in any shared organizations              |
| ✅ Scheduled tasks          | Task definitions carry over (run under the new owner) |

## What Gets Removed

For security, some account-specific items are cleared during transfer:

| Removed             | Why                                                           |
| ------------------- | ------------------------------------------------------------- |
| 🔴 Tool connections | Connected accounts belong to the original owner's credentials |
| 🔴 Co-managers      | The new owner should choose their own co-managers             |
| 🔴 Vault entries    | Secrets and API keys belong to the original owner             |

<Warning>
  The new owner will need to **reconnect any tools** the worker uses (Gmail, Slack, etc.) after accepting the transfer. Plan for this before initiating.
</Warning>

## How to Transfer a Worker

### Step 1: Initiate the Transfer

1. Open the worker you want to transfer
2. Go to **Settings** → scroll to the **Danger Zone** section
3. Click **"Transfer Worker"**
4. Enter the **email address** of the person you want to transfer to (they must already have a Spinnable account)
5. Type the **worker's name** to confirm your intent
6. Click **"Transfer Worker"** to send the invitation

<Tip>
  You can only have **one pending transfer** per worker at a time. Cancel the existing one if you need to invite someone else.
</Tip>

### Step 2: Wait for the Recipient

After sending the invitation:

* The recipient receives an **email notification**
* You'll see a pending transfer status showing the invitee's name and email
* You can **cancel the invite** at any time before they respond

### Step 3: Recipient Accepts or Declines

The recipient will see the transfer invite on their **Workers page** under a "Transfer invites" section. They can:

* **Accept** — They become the worker's new manager immediately
* **Decline** — Nothing changes; you remain the owner

## Accepting a Transfer (Recipient's View)

If someone invites you to take over their worker:

1. Go to your **Workers** page
2. Look for the **"Transfer invites"** section at the top
3. Hover over (or tap) the worker card to see **Accept** and **Decline** buttons
4. Click **Accept** to confirm — you'll see a summary of what changes:
   * You become the worker's manager
   * The worker's usage counts toward **your** plan limits and billing
   * Tool connections, co-managers, and vault entries are cleared

<Note>
  If accepting the transfer puts you over your plan's **active worker limit**, the worker will be set to inactive (holiday mode). You'll need to upgrade your plan or deactivate another worker to bring them back online.
</Note>

## After the Transfer

Once the recipient accepts:

| For the previous owner                    | For the new owner                     |
| ----------------------------------------- | ------------------------------------- |
| You lose all access to the worker         | You have full manager access          |
| The worker disappears from your workspace | The worker appears in your workspace  |
| Your tools are disconnected               | You'll need to connect your own tools |
|                                           | You can add your own co-managers      |

**New owner's checklist:**

1. ✅ Connect the tools your worker needs (Gmail, Slack, calendar, etc.)
2. ✅ Review and update vault entries if the worker uses API keys
3. ✅ Add co-managers if others need management access
4. ✅ Verify scheduled tasks are working as expected

## Canceling a Transfer

Changed your mind? While the invite is still pending:

1. Open the worker's **Settings** → **Danger Zone**
2. Find the pending transfer section showing the invitee
3. Click **"Cancel invite"**

The invitation is immediately revoked and the recipient can no longer accept.

## Requirements & Limits

| Requirement           | Details                                                                               |
| --------------------- | ------------------------------------------------------------------------------------- |
| **Who can initiate**  | Only the worker's owner (not co-managers)                                             |
| **Recipient**         | Must have an existing Spinnable account                                               |
| **Pending transfers** | Maximum one per worker at a time                                                      |
| **Self-transfer**     | Not allowed (you can't transfer to yourself)                                          |
| **Plan limits**       | The recipient's plan must have room for another worker, or it will be set to inactive |

## Tips

<Tip>
  **Communicate before transferring.** Let the recipient know what tools and vault entries the worker uses so they can prepare to reconnect everything after accepting.
</Tip>

<Tip>
  **Transfer vs. Co-Managers.** If you just need someone else to help manage a worker while you retain ownership, consider [adding a co-manager](/guides/co-managers) instead. Transfer is for permanently changing who owns the worker.
</Tip>

<Tip>
  **Organization workers stay connected.** If the worker is shared in an organization, it remains visible to org members after transfer — only the manager changes.
</Tip>

## Related

* [Co-Managers](/guides/co-managers) — Share management access without transferring ownership
* [Managing Multiple Workers](/guides/managing-multiple-workers) — Coordinate multiple workers effectively
* [Plans & Pricing](/account/plans-and-pricing) — Understand worker limits per plan