forge project list
List all platform projects accessible with the current API key.
Command
forge project list [--status <status>]
Arguments
None.
Flags
| Flag | Type | Default | Notes |
|---|---|---|---|
| string | — | Filter: | | | |
Examples
List all:
forge project list
# → prj_xxx my-app ready free
# → prj_yyy another-app ready pro
Filter by status:
forge project list --status provisioning
Errors
| Exit code | Meaning |
|---|---|
| 0 | Success |
| 2 | Auth failure (no key, invalid key) |
Pitfalls
- Admin key required — to see all projects, the API key must have
scope.admin - Pagination — output is paginated at 20 projects. Use
flag for more.--page
See also
{auto-injected}
Tested against
{auto-injected}