OMomniapp
Folders

Delete a folder

Deletes a folder. By default, non-empty folders (containing documents or sub-folders) return a 400 error. Pass force=true to recursively archive all documents (soft-delete to trash) and permanently remove all sub-folders before deleting the target folder. Force delete is limited to 100 total items (documents + sub-folders).

delete/api/v1/folders/{folderId}

Request

  • Base URL
    https://omniapp.co (the document declares no server; this is the origin it was published from)
  • URL
    https://omniapp.co/api/v1/folders/{folderId}
  • Auth
    HTTP bearer

Path parameters

folderIdstring uuid required

Unique identifier for the folder

Example:550e8400-e29b-41d4-a716-446655440000

Query parameters

forceboolean nullable

When true, recursively deletes all documents (sent to trash) and sub-folders within the folder. Limited to 100 total items (documents + sub-folders).

Response

Folder deleted successfully

successboolean required

Whether the folder was deleted successfully

Changes

No recorded changes to this operation across all 97 revisions of this API.