postship projects
List your projects and their state.
Updated on 17 September 2026
What your key may see: the projects you own, and those where you are an accepted member. One line per project — short id, name, URL, last run's verdict, when.
This command does not consume the quota: it is a read.
What PostShip does
Usage
postship projects [--json] [--fail-if-red]Options
| Option | What it does |
|---|---|
--json | The raw list. |
--fail-if-red | Exit 1 if at least one project is failing — for a watchdog script. |
Examples
postship projectsThe table.
postship projects --json | jq -r '.projects[].id'The ids, for the other commands.
Exit codes
0 · 1 with --fail-if-red when a project is red · 2 token refused or PostShip unreachable.
Troubleshooting
“No project.”
The key belongs to an account without projects, or you are a member of none. Check with postship whoami.
See also
The postship command — every command, installation and sign-in · CI recipes — complete workflows to copy.
In the terminal, postship help projects says the same; postship docs projects opens this page.