Tools Reference

Tools: Project Management

Project management tools let you create and manage isolated backend project workspaces. Each project has its own filesystem, git repository, database, and live preview URL.

zeeb_create_project

Create a new zeebpy project with git initialization.

zeeb_create_project(name: str) → str

Arguments:

Name	Type	Description
`name`	string	Project name — used as the directory and Python package name

Returns: JSON with the new project ID and workspace path.

Example prompt: "Create a new Zeeb project called ecommerce-api"

zeeb_list_projects

List all active projects for your tenant.

zeeb_list_projects() → str

Returns: JSON array of projects with IDs, names, git status, paths, and preview URLs.

zeeb_get_project

Get details of a specific project.

zeeb_get_project(project_id: str) → str

Arguments:

Name	Type	Description
`project_id`	string	UUID of the project

Returns: JSON with project metadata, git status, current branch, remote URL, and preview URL.

zeeb_archive_project

Archive a project (soft delete). The workspace is retained for recovery but the project is removed from active lists.

zeeb_archive_project(project_id: str) → str

Arguments:

Name	Type	Description
`project_id`	string	UUID of the project to archive

zeeb_reactivate_project

Reactivate an archived project. If the project has an initialized git repository and remote URL, its live preview is provisioned again.

zeeb_reactivate_project(project_id: str) → str

Arguments:

Name	Type	Description
`project_id`	string	UUID of the archived project to reactivate

zeeb_set_git_remote

Set or update the git remote URL for a project.

zeeb_set_git_remote(project_id: str, remote_url: str, remote_name: str = "origin") → str

Arguments:

Name	Type	Description
`project_id`	string	UUID of the project
`remote_url`	string	Git remote URL (e.g. `https://github.com/org/repo.git`)
`remote_name`	string	Remote name (default: `origin`)

zeeb_get_preview_url

Get the live preview URL for a project. Preview is always-on and auto-restarts.

zeeb_get_preview_url(project_id: str) → str

Returns: The HTTPS preview URL, e.g. https://<project-uuid>.preview.zeeb.cloud

zeeb_get_public_api_url

Get the runtime HTTPS API base URL for a project. Use this when building frontend integrations.

zeeb_get_public_api_url(project_id: str) → str

zeeb_get_openapi_url

Get the OpenAPI schema URL for a project. Returns the live endpoint that serves the current OpenAPI JSON.

zeeb_get_openapi_url(project_id: str) → str

Notes

All project tools require a valid project_id (UUID). Use zeeb_list_projects to find IDs.
Projects are isolated per tenant — you cannot access another tenant's projects.
Archived projects count against the project limit until permanently deleted.