Skip to content

Move a Note

POST
/api/v1/notes/{id}/move
curl --request POST \
--url https://example.com/api/v1/notes/example/move \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'If-Match: example' \
--data '{ "folder": "example" }'

Requires a signed-in User with edit access to the Note and its current ETag in If-Match. It keeps the Note ID when it changes the path. It returns 400 for an invalid destination, 412 when the Note changed, or 428 when If-Match is missing. Route: /api/v1/notes/{id}/move. Inputs: id, If-Match. Do not automatically replay this operation after an uncertain result.

id
required
string
If-Match
required
string

Current Note ETag

Media typeapplication/json
object
folder
required
string
Examplegenerated
{
"folder": "example"
}
Media typeapplication/json
object
body
required
string
canvas

Validated render data for Canvas; an invalid imported file has no scene.

etag
required
string
id
required
string
path
required
string
properties
required
title
required
string
Examplegenerated
{
"body": "example",
"canvas": "example",
"etag": "example",
"id": "example",
"path": "example",
"properties": "example",
"title": "example"
}