Deepnote research: our notes on building agents
Get started
All endpoint groups

Deepnote Public API v2

Projects API

Projects and their contents.

Base URL

https://api.deepnote.com/v2

List projects

get/projects

Parameters

pageSizequeryinteger

Maximum number of items to return. Defaults to 50. Maximum: 100.

pageTokenquerystring

Opaque token returned by the previous page. Omit for the first page.

nameContainsquerystring

Filter projects whose name contains this value (case-insensitive).

Responses

▸200Paginated list of projects
application/jsonListProjectsResponse
projectsrequiredListProjectsItem[]
paginationrequiredCursorPagination
▸400Validation error
application/jsonErrorResponse
messagerequiredstring
▸401Unauthorized
application/jsonErrorResponse
messagerequiredstring
▸403Insufficient permissions
application/jsonErrorResponse
messagerequiredstring

Create a project

post/projects

Request body

required
application/jsonCreateProjectBody
namerequiredstring

Project name.

folderIdstring:uuid

Folder to create the project in. Omit to create at the workspace root.

Responses

▸201Project created
application/jsonCreateProjectResponse
projectrequiredobject
▸400Validation error
application/jsonErrorResponse
messagerequiredstring
▸401Unauthorized
application/jsonErrorResponse
messagerequiredstring
▸403Insufficient permissions
application/jsonErrorResponse
messagerequiredstring
▸404Folder not found
application/jsonErrorResponse
messagerequiredstring

Delete a project

delete/projects/{projectId}

Parameters

projectIdpathrequiredstring:uuid

Responses

▸204Project deleted
▸400Validation error
application/jsonErrorResponse
messagerequiredstring
▸401Unauthorized
application/jsonErrorResponse
messagerequiredstring
▸403Insufficient permissions
application/jsonErrorResponse
messagerequiredstring
▸404Project not found
application/jsonErrorResponse
messagerequiredstring