---
title: "Move the agent to a team, or make it personal"
method: PATCH
path: "/agents/{id}/team"
tags: ["Agents"]
---

# Move the agent to a team, or make it personal

`PATCH /agents/{id}/team`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/agents/{id}/team`
- Auth: HTTP bearer

Owner of the agent, or an admin of the owner's company. A plain teammate (who can still view and chat with the agent) gets 404. The target team may be ANY team of the agent owner's live company. A team outside it (or a team belonging to no company) is only accepted if the CALLER belongs to it — NOT_TEAM_MEMBER otherwise.

## Path parameters

- `id` string, required

## Request body

- object
  - `teamId` string, uuid, nullable, required

## Response `200`

- object
  - `teamId` string, uuid, nullable
  - `scope` 'personal' | 'team'

## Other responses

- `400`: teamId must be a string or null
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `403`: NOT_TEAM_MEMBER
- `404`: Agent not found (or not yours to administer), or teamId does not exist

---

[API](https://skmtc.dev/atako/apis/atako-api.md) · [All operations](https://skmtc.dev/atako/apis/atako-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atako/apis/atako-api/revisions/aa555c56fbd7?raw)