Sign in
contents

Create a new file in the specified path

A POST to /api/contents/path creates a New untitled, empty file or directory. A POST to /api/contents/path with body {'copy_from': '/path/to/OtherNotebook.ipynb'} creates a new copy of OtherNotebook in path.

post/api/contents/{path}

Path parameters

pathstring required

file path

Request body

copy_fromstring
extstring
typestring

Response

File created

namestring required

Name of file or directory, equivalent to the last part of the path

pathstring required

Full path for file or directory

type'directory' | 'file' | 'notebook' required

Type of content

writableboolean required

indicates whether the requester has permission to edit the file

createdstring dateTime required

Creation timestamp

last_modifiedstring dateTime required

Last modified timestamp

sizeinteger

The size of the file or notebook in bytes. If no size is provided, defaults to null.

mimetypestring required

The mimetype of a file. If content is not null, and type is 'file', this will contain the mimetype of the file, otherwise this will be null.

formatstring required

Format of content (one of null, 'text', 'base64', 'json')

hashstring

[optional] The hexdigest hash string of content, if requested (otherwise null). It cannot be null if hash_algorithm is defined.

hash_algorithmstring

[optional] The algorithm used to produce the hash, if requested (otherwise null). It cannot be null if hash is defined.

Changes