Skip to main content
PUT
/
browser
/
sessions
/
{id}
/
fs
/
move
Move Path
curl --request PUT \
  --url https://api.example.com/browser/sessions/{id}/fs/move \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "<string>",
  "to": "<string>"
}
'
{
  "from": "<string>",
  "to": "<string>"
}

​
Overview

Renames or moves a file or directory within the session’s workspace. Both from and to must be workspace-relative (no leading /, no ..). Cross-filesystem moves are not supported — both paths live inside the same workspace.

​
Path Parameters

​
id
string
required
Browser session ID (UUID).

​
Body

​
from
string
required
Source workspace-relative path.
​
to
string
required
Destination workspace-relative path.

​
Example Request

curl -X PUT "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/fs/move" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "downloads/invoice.pdf",
    "to": "archive/2026/invoice.pdf"
  }'

​
Response

​
Success Response (200)

​
from
string
Original workspace-relative path.
​
to
string
New workspace-relative path.
Example Response: 
{
  "from": "downloads/invoice.pdf",
  "to": "archive/2026/invoice.pdf"
}

​
Error Responses

StatusDescription
400Invalid from or to.
401Unauthorized — invalid or missing API key.
404Session or source path not found.
409Destination already exists or crosses a non-directory.