Delete a folder by path

DELETE

/folders/*path

const url = 'https://api.engram.page/folders/*path';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url 'https://api.engram.page/folders/*path' \
  --header 'Authorization: Bearer <token>'

Removes the folder marker for the given path. Idempotent — deleting a non-existent or never-encrypted folder still returns 204. Pass recursive=true to also delete every note and attachment under the path — required to remove a folder that has no marker of its own (one the server only derives from the paths of the notes inside it).

Authorizations

bearerAuth

Parameters

Path Parameters

path

required

string

Folder path

Query Parameters

recursive

string

“true” also deletes every note and attachment under the path. Omit for marker-only. Declared as a string, not a boolean, because nothing casts query params here — a value this does not recognize would silently no-op a destructive call.

Responses

204

Deleted (empty body)