latestOpenAPI 3.1.02026-08-204489152.5 KB

726970fd2992

Projects

Import a project ZIP archive

Reconciles an existing project from the ZIP produced by project export. Before applying changes, Deepnote creates a version-history snapshot of the project's current notebook state, which can be used to restore notebooks to their pre-import state. Importing a notebook clears the outputs and execution state of all its blocks; notebooks omitted from a partial import are unchanged. Each .deepnote document must contain exactly one notebook from the target project and use the same project name and, when present, integration attachments. The project name and declared integration attachments are applied during import; changing the project name requires project rename permission. Notebooks are matched by document-facing id. Missing notebooks are left untouched unless deleteMissingNotebooks=true. Requirements are not imported.

post/projects/{projectId}/import

Path parameters

projectIdstring uuid required

Query parameters

baseModifiedAtstring date-time

Structural version from the export this import is based on. The import returns 409 when the project structure has changed since this timestamp.

Structural version from the export this import is based on. The import returns 409 when the project structure has changed since this timestamp.

baseContentHashstring

Canonical lowercase SHA-256 hash of the exploded .deepnote documents.

Example:2f3a4b5c6d7e8f90123456789abcdef02f3a4b5c6d7e8f90123456789abcdef0

Canonical content hash from the export this import is based on. The import returns 409 when the currently exported documents differ.

deleteMissingNotebooks'true' | 'false'

Delete active project notebooks that are absent from the archive. Defaults to false, which leaves missing notebooks untouched.

Delete active project notebooks that are absent from the archive. Defaults to false, which leaves missing notebooks untouched.

force'true' | 'false'

Skip both lost-update checks and then import regardless of concurrent project changes. Defaults to false.

Skip both lost-update checks and then import regardless of concurrent project changes. Defaults to false.

Response

Project notebooks reconciled

Example response

{
  "project": {
    "contentHash": "2f3a4b5c6d7e8f90123456789abcdef02f3a4b5c6d7e8f90123456789abcdef0"
  }
}