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

# Organization agents

> Create identities that Mesa uses to run unattended work on your organization's behalf.

An agent is an identity that Mesa uses to run unattended work for your organization. It works like a member account: it holds roles, team memberships, shares, and credit limits. Unlike a member, an agent never signs in. It can only reach what you grant it, so give each agent only the roles and shares its work needs.

<Warning>
  Only users with the **Owner** role can open the Organization page and manage agents.
</Warning>

## Open the Agents page

Open the Organization page and choose **Agents** from the sidebar. The page lists your organization's agents with their email, roles, teams, and credits used. Switch between **Active** and **Inactive** to see deactivated agents.

<Frame>
  <img src="https://mintcdn.com/calderapbc/eLrCeNhG02pioep2/images/new-2026-09/org-agents-list.png?fit=max&auto=format&n=eLrCeNhG02pioep2&q=85&s=7fc72822b0c649e77fca06695769e26a" alt="The Agents page with the Agents sidebar entry and the Add agent button highlighted" width="2494" height="1770" data-path="images/new-2026-09/org-agents-list.png" />
</Frame>

<Note>
  Agents are listed only on the Agents page. The **Members** list shows people only.
</Note>

## Add an agent

<Steps>
  <Step title="Start a new agent">
    Click **Add agent** on the Agents page.
  </Step>

  <Step title="Fill in the details">
    * **Email**: enter the first part of the address. Mesa assigns the rest on your organization's own agent domain. You can't change the address later.
    * **Display name**: the name members see wherever the agent appears.
    * **Roles**: the roles the agent holds, just like a member's.
    * **Credit limits**: the agent's daily and weekly limits.

    <Frame>
      <img src="https://mintcdn.com/calderapbc/eLrCeNhG02pioep2/images/new-2026-09/org-agents-new.png?fit=max&auto=format&n=eLrCeNhG02pioep2&q=85&s=826f21d5e52d8ea4a9d1d5e273cb644d" alt="The New agent form filled in, with the Create button highlighted" width="2494" height="1770" data-path="images/new-2026-09/org-agents-new.png" />
    </Frame>
  </Step>

  <Step title="Create the agent">
    Click **Create**. Mesa opens the agent's page.
  </Step>
</Steps>

## Manage an agent

Click an agent in the list to open its page. An **Agent** badge sits next to its name. From here you can:

* Click **Edit** to change its display name, roles, or credit limits.
* Click **Add to Team** to give it the roles of a [team](/teams).
* Review its daily and weekly usage under **Current Usage**.
* Click **Deactivate** to stop Mesa from running work as the agent. Deactivated agents move to the **Inactive** list.

<Frame>
  <img src="https://mintcdn.com/calderapbc/eLrCeNhG02pioep2/images/new-2026-09/org-agents-detail.png?fit=max&auto=format&n=eLrCeNhG02pioep2&q=85&s=cb18064e59e23fe183565753161be06b" alt="An agent's page showing its email, roles, credit limits, teams, and usage" width="2494" height="1770" data-path="images/new-2026-09/org-agents-detail.png" />
</Frame>

## Related articles

<Card title="Organization admin" href="/organization-admin" horizontal>
  Add members, assign roles, and monitor usage across your workspace.
</Card>

<Card title="Teams" href="/teams" horizontal>
  Group members and agents into teams that share the same roles.
</Card>

<Card title="Organization audit log" href="/organization-audit-log" horizontal>
  Review activity across your organization, including work done by agents.
</Card>
