Deepnote Public API v2
Files API
Project files and folders.
Base URL
https://api.deepnote.com/v2Create a file
Creates a file from a multipart upload at the requested project path, generating a unique path when that path already exists.
/filesRequest body
CreateFileMultipartBodyprojectIdrequiredstring:uuidProject to create the file in.
pathrequiredstringRequested destination path within the project. If it already exists, a unique path is generated.
filerequiredstring:binaryFile content to upload.
Responses
▸201File created
CreateFileResponsefilerequiredFileReference▸400Validation error
ErrorResponsemessagerequiredstring▸401Unauthorized
ErrorResponsemessagerequiredstring▸403Insufficient permissions
ErrorResponsemessagerequiredstring▸404Project not found
ErrorResponsemessagerequiredstring▸409Project is suspended
ErrorResponsemessagerequiredstring▸413File too large
ErrorResponsemessagerequiredstring▸429Rate limit exceeded
ErrorResponsemessagerequiredstringDelete a file
/filesParameters
projectIdqueryrequiredstring:uuidProject that contains the file.
pathqueryrequiredstringFile path within the project.
Responses
▸204File deleted
▸400Validation error
ErrorResponsemessagerequiredstring▸401Unauthorized
ErrorResponsemessagerequiredstring▸403Insufficient permissions
ErrorResponsemessagerequiredstring▸404File not found
ErrorResponsemessagerequiredstring▸409Project is suspended
ErrorResponsemessagerequiredstring▸429Rate limit exceeded
ErrorResponsemessagerequiredstringCopy a file between projects
Copies a source file into another project, using the source file path as the target path.
/files/copyRequest body
CopyFileBodysourceProjectIdrequiredstring:uuidProject that contains the source file.
targetProjectIdrequiredstring:uuidProject to copy the file into.
sourceFilePathrequiredstringFile path within the source project. The same normalized path is used in the target project.
Responses
▸201File copied
CopyFileResponsefilerequiredFileReference▸400Validation error
ErrorResponsemessagerequiredstring▸401Unauthorized
ErrorResponsemessagerequiredstring▸403Insufficient permissions
ErrorResponsemessagerequiredstring▸404Project or file not found
ErrorResponsemessagerequiredstring▸409Project is suspended or target file already exists in the destination project
ErrorResponsemessagerequiredstring▸429Rate limit exceeded
ErrorResponsemessagerequiredstringDownload a file
Streams the raw content of a file from the project filesystem.
/files/downloadParameters
projectIdqueryrequiredstring:uuidProject that contains the file.
pathqueryrequiredstringFile path within the project.
Responses
▸200Raw file content
string:binary▸400Validation error or path is not a file
ErrorResponsemessagerequiredstring▸401Unauthorized
ErrorResponsemessagerequiredstring▸403Insufficient permissions
ErrorResponsemessagerequiredstring▸404File not found
ErrorResponsemessagerequiredstring▸409Project is suspended
ErrorResponsemessagerequiredstring▸429Rate limit exceeded
ErrorResponsemessagerequiredstring▸500Internal server error
ErrorResponsemessagerequiredstring