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

# Assign an agent to a client

> Learn how to assign, reassign, and unassign agents to clients in Brandless.

Assign agents to clients so they can use them in their dashboard. An agent can be assigned to at most one client — reassigning moves it to a new client, while its conversations and knowledge base stay with the original client.

## Why assign an agent to a client?

Before you can configure an agent's knowledge base, tools, or phone numbers, it must be assigned to a client. Assigning makes the agent appear in that client's dashboard and lets them use it.

## Steps

<Steps>
  <Step title="Open the client's Assigned solutions tab">
    Go to **Clients**, select a client, then click the **Assigned solutions** tab.
  </Step>

  <Step title="Click Assign agent">
    Press the **Assign agent** button in the top right.
  </Step>

  <Step title="Choose an agent">
    Select an agent from the list. Agents already assigned to another client show an amber warning with the current client's name. Choosing one will move it to this client.

    Unassigned agents appear with "Unassigned" on the right.
  </Step>
</Steps>

## Reassign or remove an agent

To move an agent to a different client or unassign it:

<Steps>
  <Step title="Find the agent in the list">
    On the client's **Assigned solutions** tab, locate the agent you want to change.
  </Step>

  <Step title="Open the menu">
    Click the three-dot menu on the right side of the agent's row.
  </Step>

  <Step title="Choose an action">
    * Select **Reassign to** and pick another client to move the agent
    * Select **Remove from client** to unassign it (it stays in your agency but belongs to no client)
  </Step>
</Steps>

<Note>
  When you reassign an agent, its conversation history, knowledge base documents, and phone numbers remain recorded under the original client. Only the agent itself moves.
</Note>

<Warning>
  Unassigned agents cannot be configured. You must assign an agent to a client before you can add its knowledge base or tools.
</Warning>

## Related

* [Create an agent](/docs/agents/create)
* [System prompt](/docs/agents/system-prompt)
* [Create a client](/docs/clients/create)