postship wait
Wait until the last ship is concluded (or carries a commit), then return its verdict.
Updated on 17 September 2026
On this page
Every fifteen seconds, reads the last production ship. As soon as it is concluded — verdict set, score set — the command returns that verdict. With --sha, it waits for that commit's ship, not yesterday's. Read only: nothing is consumed.
This command does not consume the quota: it is a read.
What PostShip does
Usage
postship wait --project <id> [--sha <abcdef>] [--timeout <s>] [--min-score <n>] [--json]Options
| Option | What it does |
|---|---|
--project, -p <id> | The project. |
--sha <abcdef> | The beginning of the expected commit ($GITHUB_SHA). |
--timeout <s> | How many seconds to wait at most (600). |
--min-score <n> | Exit 1 when the ship's score is below this threshold. |
--json | The concluded ship's raw response. |
Examples
postship wait -p 3f1c… --sha "$GITHUB_SHA" --timeout 600After vercel deploy, in the same job.
postship wait --min-score 80With ./.postship.json.
Exit codes
0 concluded and good · 1 failing ship or score below threshold · 2 timed out (could not conclude), project not found, token, network.
Troubleshooting
Timed out while the deploy is live
PostShip did not see this deploy: the host is not connected, or the commit does not match (--sha). Project → Deployments shows what was seen.
See also
The postship command — every command, installation and sign-in · CI recipes — complete workflows to copy.
In the terminal, postship help wait says the same; postship docs wait opens this page.