Move Folder Entities

POST /api/public/v2/folders/entities

Move Folder Entities

cURL

curl --request POST \
  --url https://api.promptlayer.com/api/public/v2/folders/entities \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "entities": [
    {
      "id": 123
    }
  ],
  "folder_id": 123,
  "workspace_id": 123
}
'

200

{
  "moved_count": 123
}

Moves one or more entities into a target folder, or to the workspace root if no folder_id is provided. Supports moving folders, prompts, snippets, workflows, datasets, evaluations, AB tests, and input variable sets. Requires appropriate edit permissions for each entity type.

Authorizations

X-API-KEY · string · header · required

Body

application/json

entities · EntityReference · object[] · required

List of entities to move.

Show child attributes

folder_id · integer | null

The ID of the destination folder. If null or not provided, entities are moved to the workspace root.

workspace_id · integer

The ID of the workspace.

Response

200

application/json

Entities moved successfully

moved_count · integer

The number of entities affected by the operation.