---
title: "Move up to 100 records with partial results"
method: POST
path: "/folders/bulk-move"
tags: ["Folders"]
---

# Move up to 100 records with partial results

`POST /folders/bulk-move`

## Request

- Base URL: `https://app.arkova.ai/api/v1`
- URL: `https://app.arkova.ai/api/v1/folders/bulk-move`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Request body

- union
  - object
    - `anchor_ids` string[], required: Internal UUID compatibility input for dashboard clients.
    - `record_public_ids` string[]: API-visible record public ids. Outcomes preserve these identifiers.
    - `folder_id` string, uuid, nullable, required: Null moves records to Unfiled.
  - object
    - `anchor_ids` string[]: Internal UUID compatibility input for dashboard clients.
    - `record_public_ids` string[], required: API-visible record public ids. Outcomes preserve these identifiers.
    - `folder_id` string, uuid, nullable, required: Null moves records to Unfiled.

## Response `200`

Every record moved

- FolderMoveResult
  - `moved` union[], required
    - union
      - string, uuid
      - string
  - `failed` object[], required
    - `anchor_id` union, required
      - string, uuid
      - string
    - `code` string, required

## Other responses

- `207`: Authorized records moved; rejected rows are listed independently
- `400`: Invalid request
- `401`: Authentication required

---

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