====== Folders ======

The folder api allows listing, creating, updating and deleting folders.

----
[[https://git.mdns.eu/nextcloud/passwords/-/wikis/Developers/Api/Folder-Api|Link to documentation]]
----

===== Fields =====
  * id: String, R, Unencrypted, Unversioned
  * //**__label: String, RW, Encrypted, Versioned__**//
  * //__parent: String, RW, Unencrypted, Versioned__//
  * //revision: String, R, Unencryptred, Versioned//
  * //__cseType: String, RW, Unencryptred, Versioned__//
  * //__cseKey: String, RW, Unencryptred, Versioned__//
  * //sseType: String, R, Unencryptred, Versioned//
  * //client: String, R, Unencryptred, Versioned//
  * //__hidden: Boolean, RW, Unencryptred, Versioned__//
  * //trashed: Boolean, R, Unencryptred, Versioned//
  * //__favorite: Booelean, RW, Unencryptred, Versioned__//
  * created: Integer, R, Unencryptred, Unversioned
  * //updated: Integer, R, Unencryptred, Versioned//
  * //__edited: Integer, RW, Unencryptred, Versioned__//

Bold: Encrypted, Italic: Version, Underline: RW

----
==== Detail-Levels: ====
  * model: Returns the base model (Default)
  * revisions: Adds the revisions property which contains all revisions. A revision consists of all properties marked as versioned and its own created property
  * parent: Fills the parent property with the base model of the parent folder
  * folders: Adds the folders property with the base model of all folders in this folder
  * folder-ids: Adds the folders property with the ids of all folders in this folder. Can not be used with +folders
  * passwords: Adds the passwords property with the base model of all passwords in this folder
  * password-ids: Adds the passwords property with the ids of all passwords in this folder. Can not be used with +passwords
  * password-tags: Loads the tags for all passwords in this folder in their respective model. Can only be used with +passwords
  * tags: Not implemented but reserved


----

==== Operations ====
  * [[220|List: /api/1.0/folder/list: GET]] 
  * [[220|List: /api/1.0/folder/list: POST]]
  * [[222|Show: /api/1.0/folder/show: POST]]
  * [[222|Find: /api/1.0/folder/find: POST]]
  * [[223|Create: /api/1.0/folder/create: POST]]
  * [[224|Updated: /api/1.0/folder/update: PATCH]]
  * [[225|Delete: /api/1.0/folder/delete: DELETE]]
  * [[226|Restore: /api/1.0/folder/restore: PATCH]]