Sign in

v29

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-233765161.7 KB
v1 projects

Clone a project

Deep-clone a project, including all its Neo4j memory graph data and referenced GCS assets, into a new independent project.

This endpoint:
- Creates a new project in PostgreSQL with the source project's metadata
- Copies all GCS files (images, objects) under a new project path
- Deep-copies all Neo4j nodes (episodes, entities, preferences, identity,
  hierarchical data, multimodal nodes) with new UUIDs
- Rewrites GCS URLs in ImageNode/ObjectNode to point at the copied files
- Recreates all inter-node relationships

The clone is fully independent — changes to one project do not affect the other.

**Authentication**: Requires valid API key or JWT token
post/v1/projects/clone

Request body

source_user_idstring

User ID of the source project owner. If not provided, uses the authenticated user's ID.

project_idstring required

ID of the project to clone

namestring nullable

Name for the cloned project. Defaults to '{original_name} (Copy)'.

descriptionstring nullable

Description for the cloned project. Defaults to the original's description.

target_user_idstring nullable

Target user ID to own the cloned project. If not provided, uses the authenticated user.

Response

Successful Response

messagestring required

Success message

source_project_idstring required

ID of the original project that was cloned