Projects

Organize databases into projects.

Overview

Projects are the top-level organizational unit in Postbase Cloud:

Organization (your account)
└── Project (myapp)
    ├── Database (production)
    ├── Database (staging)
    └── Database (development)

Creating Projects

Via CLI

postbase cloud projects create myapp

Output:

✓ Project created
 
ID:   proj_D3uqtMIZXOoU
Name: myapp
 
Next: Provision a database with:
  postbase cloud provision production -p myapp

Naming Rules

Lowercase letters, numbers, hyphens
Must start with a letter
3-50 characters
Unique within your account

Valid: myapp, my-app-2, production-api Invalid: My App, 123app, my_app

Listing Projects

postbase cloud projects list

Output:

Projects
 
ID                     NAME           DATABASES    CREATED
proj_D3uqtMIZ...      myapp          3            2026-01-20
proj_K9Rvw2Hx...      demo-app       1            2026-01-15
proj_P7nFqLmA...      api-service    2            2026-01-10
 
Total: 3 projects

JSON Output

postbase cloud projects list --json

Project Details

postbase cloud projects info myapp

Output:

Project: myapp
 
ID:        proj_D3uqtMIZXOoU
Created:   2026-01-20 10:00:00 UTC
 
Databases (3):
  production     running     us-west1    12.5 GB
  staging        running     us-west1    3.2 GB
  development    running     us-west1    1.1 GB
 
Total Storage: 16.8 GB

Deleting Projects

# With confirmation
postbase cloud projects delete myapp
 
# Force delete
postbase cloud projects delete myapp --force

You must delete all databases first, or use --force.

Project Settings

Default Region

Set default region for new databases:

postbase cloud projects settings myapp --default-region eu-west1

Project Limits

Tier	Databases per Project
Free	3
Pro	Unlimited

Working with Multiple Projects

CLI Project Flag

Most commands accept -p or --project:

# Specify project explicitly
postbase cloud databases list -p myapp
postbase cloud provision staging -p myapp
postbase cloud backups list -p myapp -d production

Default Project

Set a default project:

postbase cloud projects default myapp

Then omit -p:

postbase cloud databases list  # Uses myapp

Project Context

View current project context:

postbase cloud projects current

Current project: myapp (proj_D3uqtMIZ...)

Project-Level Resources

Resources scoped to projects:

Resource	Scope
Databases	Per project
Backups	Per database (within project)
WAL Archives	Per database (within project)
Settings	Per project

API

List Projects

GET /projects
Authorization: Bearer <token>

Create Project

POST /projects
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "name": "myapp"
}

Get Project

GET /projects/:id
Authorization: Bearer <token>

Delete Project

DELETE /projects/:id
Authorization: Bearer <token>