Projects API

The Projects API allows you to manage projects within workspaces, including creation, import/export, and template management.

Save Project

Create or update a project in a workspace.
import prometheux_chain as px

# Create a new project
project_id = px.save_project(project_name="my_project")

# Update an existing project
updated_project_id = px.save_project(
    project_id="existing_id", 
    project_name="updated_name"
)
Function Signature
def save_project(project_id=None, project_name=None, project_scope="user", description=None)
Parameters
ParameterTypeRequiredDescription
project_idstrNoThe project identifier. If None, a new project will be created
project_namestrYes*The name of the project. Required when creating a new project
project_scopestrNoThe scope of the project. Defaults to “user”
descriptionstrNoOptional project description
ReturnsThe project ID of the created or updated project.

List Projects

List all projects in a workspace.
import prometheux_chain as px

# List all user projects
projects = px.list_projects()

# List projects with specific scopes
projects = px.list_projects(project_scopes=["user", "shared"])

Load Project

Load a specific project by ID.
import prometheux_chain as px

project_data = px.load_project(project_id="my_project_id")

List Templates

List all available project templates from the marketplace.
import prometheux_chain as px

templates = px.list_templates()
for template in templates:
    print(f"Template: {template['name']} (ID: {template['id']})")

Import Template

Import a project from a marketplace template.
import prometheux_chain as px

result = px.import_template(
    template_id="template_001", 
    new_project_name="My Financial Analysis"
)

Export Project

Export a project including all its data and metadata.
import prometheux_chain as px
import json

export_data = px.export_project(project_id="proj_12345")

with open("project_export.json", "w") as f:
    json.dump(export_data, f)

Import Project

Import a previously exported project into a workspace.
import prometheux_chain as px
import json

with open("project_export.json", "r") as f:
    export_data = json.load(f)

result = px.import_project(export_data=export_data)

Copy Project

Copy a project within or between workspaces.
import prometheux_chain as px

result = px.copy_project(
    "proj_12345",
    target_scope="user",
    new_project_name="Copy of Financial Analysis",
)

Cleanup Projects

Delete projects from a workspace.
import prometheux_chain as px

# Clean up all user projects
px.cleanup_projects()

# Clean up a specific project
px.cleanup_projects(project_id="my_project_id")

Export Workspace

Export all projects and workspace data for the given scope.
import prometheux_chain as px

export_data = px.export_workspace(scope="user")

Import Workspace

Import workspace data previously produced by export workspace.
import prometheux_chain as px

result = px.import_workspace(export_data, scope="user")