Projects & orgs

A project is the primary tenant boundary in Veirox. Every resource — tasks, sessions, entities, secrets, files — belongs to exactly one project.

Org → Project → Resources

An org is the top-level billing and membership boundary. Inside an org you create projects (e.g. production, staging, sandbox). Every API call carries an X-Project-ID header that the backend uses to scope queries. The CLI sets this automatically from the active profile's project_id in ~/.config/veirox/config.toml.

Common operations

veirox project list
veirox project create "Core Platform" --slug core-platform
veirox project info <project-id>
veirox org list

Switching projects

Run veirox init to interactively pick a project, which updates your active profile. Or set VEIROX_PROJECT_ID in your environment to override for a single session:

export VEIROX_PROJECT_ID=00000000-0000-4000-8000-000000000001
veirox task list

Members & roles

Roles: owner, admin, member, viewer. API keys inherit the role of the creating user unless a narrower scope is specified with --scope.

See also