---
title: "Move Agents To Folder"
method: POST
path: "/v2/teams/{teamId}/agent-folders/move-agents"
tags: ["Agent Folders"]
---

# Move Agents To Folder

`POST /v2/teams/{teamId}/agent-folders/move-agents`

Move one or more agents (assignments) into a folder, or to the root level.

## Path parameters

- `teamId` string, required

## Request body

- object
  - `agent_ids` string[], required — IDs of the agents (assignments) to move. Must be unique.
  - `folder_id` string, uuid, nullable, required — Destination folder ID. Pass null to move the agents to the root level.

## Response `200`

Default Response

- object
  - `success` boolean, required — Always true on success
  - `moved_count` number, required — Number of agents that were moved

## Other responses

- `400` — Default Response
- `401` — Default Response
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)