Sign in
notebook-folder-controller

Create a folder

Creates a folder at notebook root when no parent is specified; as a child of underFolderId when set; otherwise nested under the context note's folder when underNoteId is set (underFolderId takes precedence when both are set).

post/api/notebooks/{notebook}/folders

Path parameters

notebookinteger required

Request body

namestring required

Display name for the new folder

underFolderIdinteger

When set, the new folder is created as a direct child of this folder. Must belong to the target notebook. Takes precedence over underNoteId when both are set.

underNoteIdinteger

When set (and underFolderId is not), the new folder is a child of this note's folder (or notebook root when the note has no folder). Must belong to the target notebook.

Response

OK

Changes

Changed in 5 of the 195 revisions of this API.34

  • b88bb26a237e2See the full diff
    • ○

      api tag notebook-folder-controller added

      api-tag-added

    • ○

      api tag notebook-controller removed

      api-tag-removed

  • 6c31eea0ac371See the full diff
    • ●

      changed the pattern of the request property from ^[^\\/:]*$ to ^[\s\x00-\x1F]*[^\\/:*?"<>|\x00-\x1F]*[\s\x00-\x1F]*$

      request-property-pattern-changed

  • 13f77438750e11See the full diff
    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • de5624b4a98c1See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • d7c2946139e91See the full diff
    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog