Skip to main content
POST
Add an item to a folder

Authorizations

Authorization
string
header
required

Workspace API key (lora_sk_…) sent as Authorization: Bearer <api_key>. Each scoped operation names the scope it requires in its security requirement, for example shortcuts.write; a key without it receives 403 with code: insufficient_scope. GET /v1/qr also accepts anonymous requests and requires no scope.

Scopes

folders.write

Path Parameters

id
string
required

The folder's unique ID.

Pattern: ^[0-9abcdefghjkmnpqrstvwxyz]{8}$
Example:

"a1b2c3d4"

Body

application/json

Payload to add an existing item to a folder

itemId
string<uuid>
required

The ID of the item to add to this folder

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
Example:

"019e8ef6-9a84-7de9-877d-9e9ee171a8c2"

itemType
enum<string>
default:shortcut

The kind of item. Only shortcut is supported today.

Available options:
shortcut
Example:

"shortcut"

Response

Item added to the folder (or already present).

added
enum<boolean>
required
Available options:
true