Creating Projects

Projects organize your functions, durable functions, databases, authentication, file storage, realtime, frontend hosting, and distributed locks.

Create a Project

curl -X POST https://api.volcano.dev/projects \
  -H "Authorization: Bearer $PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-app"}'

Create a project restricted to one region (SUPERAGENT plan):

curl -X POST https://api.volcano.dev/projects \
  -H "Authorization: Bearer $PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-app","all_regions":false,"selected_regions":["us-east-1"]}'

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-app",
  "status": "active",
  "all_regions": true,
  "selected_regions": ["us-east-1", "us-west-2"],
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}

Fields:

id - Unique project identifier (use in all API calls)
status - active, provisioning, or failed

Save the id - you'll need it for all project operations.

Update project name or region policy

curl -X PATCH https://api.volcano.dev/projects/PROJECT_ID \
  -H "Authorization: Bearer $PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-app-renamed"}'

Switch to a single-region policy:

curl -X PATCH https://api.volcano.dev/projects/PROJECT_ID \
  -H "Authorization: Bearer $PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"all_regions":false,"selected_regions":["us-east-1"]}'

List Your Projects

curl https://api.volcano.dev/projects \
  -H "Authorization: Bearer $PLATFORM_TOKEN"

With pagination:

curl "https://api.volcano.dev/projects?page=1&limit=20" \
  -H "Authorization: Bearer $PLATFORM_TOKEN"

Get Project Details

curl https://api.volcano.dev/projects/PROJECT_ID \
  -H "Authorization: Bearer $PLATFORM_TOKEN"

Delete a Project

curl -X DELETE https://api.volcano.dev/projects/PROJECT_ID \
  -H "Authorization: Bearer $PLATFORM_TOKEN"

Warning: This deletes:

All functions in the project
All databases in the project
All auth users in the project
All tokens
All variables
All anon keys
All sessions and related data

This action cannot be undone.