Projects & Environments

Secrets are organized as org / project / environment / key. Projects group related secrets. Environments separate configuration per deployment stage.

Projects

Create a project

coldrune project create --org my-org --name api-backend

Three default environments are created automatically: dev, staging, prod.

List projects

coldrune project list --org my-org

Rename

coldrune project update --org my-org --name api-backend --new-name api-service

Delete

coldrune project delete --org my-org --name api-backend

Environments

Create an environment

coldrune env create --org my-org --project api-backend --name qa

List environments

coldrune env list --org my-org --project api-backend

Delete an environment

coldrune env delete --org my-org --project api-backend --name qa

Naming rules

Project and environment names follow the same rules as organization names: 2-50 characters, lowercase alphanumeric with hyphens, starting and ending with an alphanumeric character.

REST API

# Create project
curl -X POST http://localhost:7100/api/orgs/my-org/projects \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "api-backend"}'

# List environments
curl http://localhost:7100/api/orgs/my-org/projects/api-backend/envs \
  -H 'Authorization: Bearer <token>'

# Create environment
curl -X POST http://localhost:7100/api/orgs/my-org/projects/api-backend/envs \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "qa"}'