---
title: "Move record to another location"
method: PUT
path: "/knowledgeBase/{kbId}/record/{recordId}/move"
tags: ["Knowledge Base"]
---

# Move record to another location

`PUT /knowledgeBase/{kbId}/record/{recordId}/move`

Move a file or folder record to a different location within the same knowledge base.

Set `newParentId` to a folder ID to move the record into that folder, or `null` to move it to the knowledge base root.

**Required Permission:** OWNER or WRITER

## Path parameters

- `kbId` string, uuid, required
- `recordId` string, required

## Request body

- KnowledgeBaseMoveRecordRequestBody — Request body for PUT /knowledgeBase/{kbId}/record/{recordId}/move (moveRecord).
  - `newParentId` string, nullable, required — Target folder ID, or null to move the record to the knowledge base root

## Response `200`

Record moved successfully

- KnowledgeBaseMoveRecordResponse — Response returned by PUT /knowledgeBase/{kbId}/record/{recordId}/move (moveRecord).
  - `success` boolean, required
  - `message` string, required

## Other responses

- `400` — Invalid request. Possible reasons: - Missing `newParentId` in the request body - Invalid `kbId` (must be a UUID) - Empty `recordId` - Cannot move a folder into itself - Cannot move a folder into one of its own sub-folders (circular reference)
- `401` — Unauthorized - Valid bearer token required
- `403` — Forbidden. Possible reasons: - OAuth token lacks the `kb:write` scope - User lacks OWNER or WRITER permission on the knowledge base
- `404` — Not found. Possible reasons: - Knowledge base does not exist - Record does not exist in the knowledge base - Target folder does not exist in the knowledge base
- `500` — Internal server error while moving record
- `503` — Connector service unavailable or connection refused

## Changes

- **2026-06-30** `059c619e9b99` — 2 info
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
- **2026-06-29** `911a57b55d18` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pipeshub-ai/apis/pipeshub-api/changes/knowledgeBase/:kbId/record/:recordId/move/put.md)

---

[API](https://skmtc.dev/pipeshub-ai/apis/pipeshub-api.md) · [All operations](https://skmtc.dev/pipeshub-ai/apis/pipeshub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pipeshub-ai/pipeshub-api/revisions/64bfe76b130e/schema)