---
title: "Move Entity To Folder"
method: POST
path: "/v1/convai/knowledge-base/{document_id}/move"
tags: ["Conversational AI"]
---

# Move Entity To Folder

`POST /v1/convai/knowledge-base/{document_id}/move`

Moves the entity from one folder to another.

## Path parameters

- `document_id` string, required — The id of a document from the knowledge base. This is returned on document addition.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyMoveEntityToFolderV1ConvaiKnowledgeBaseDocumentIdMovePost
  - `move_to` string, nullable — The folder to move the entities to. If not set, the entities will be moved to the root folder.

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

---

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