BlueForge Docs

forge project list

List all platform projects accessible with the current API key.

Command

forge project list [--status <status>]

Arguments

None.

Flags

FlagTypeDefaultNotes
--status
stringFilter:
ready
|
provisioning
|
error
|
deleted

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 codeMeaning
0Success
2Auth failure (no key, invalid key)

Pitfalls

  • Admin key required — to see all projects, the API key must have
    admin
    scope.
  • Pagination — output is paginated at 20 projects. Use
    --page
    flag for more.

See also

{auto-injected}

Tested against

{auto-injected}