Skip to content

Creating and deleting projects via API#

Open in Colab

You can do various project administration tasks with the management API.

In this basic guide, we show you how to:

  1. Create a new project
  2. List the projects you have access to
  3. Delete a project

Creating a project#

Before you start: Obtain the name of the workspace where the project should be created.

To create a new project, import the management package and use the create_project() function:

from neptune import management

management.create_project(
    name="named-entity-recognition",  # (1)!
    key="NER",
    workspace="ml-team",
    visibility="priv",
    description="Team-wide NER project for important conference"
)
  1. You can also prefix the workspace name here and omit the workspace parameter. For example, name="ml-team/named-entity-recognition"

Note

The project name is case-insensitive. For example, CV-Project and cv-project will be treated as the same.

  • You must supply the workspace and project name; everything else is optional.
  • If you omit the key argument, Neptune generates a project key for you based on the project name.

Expected output

If the project was created successfully, Neptune returns the full name of the new project:

'ml-team/named-entity-recognition'

Listing projects you have access to#

To get a list of all projects you have access to, import the management package and use the get_project_list() function:

from neptune import management

management.get_project_list()  # (1)!
  1. We recommend saving your API token as an environment variable. If needed, you can pass it as an argument here: management.get_project_list(api_token="h0dHBzOi8aHR0cHM6Lkc...")

Expected output

A list of project names that the account associated with the API token has access to. For example:

['jackie/sandbox', 'jackie/thesis-project', 'ml-team/classification', 'ml-team/test']

Deleting a project#

Before you start: Obtain the name of the project and the workspace where it's located.

To delete a project, import the management package and use the delete_project() function:

from neptune import management

management.delete_project(
    project="named-entity-recognition",  # (1)!
    workspace="ml-team",
)
  1. You can also prefix the workspace name here and omit the workspace parameter. For example, project="ml-team/named-entity-recognition"

Expected output

If there is no error message, the project was deleted successfully.

Related