postship ship
The last production deployment and its score.
Updated on 17 September 2026
On this page
The last tracked production deploy — not a preview — with its origin (vercel, netlify, cloudflare, generic, fingerprint), the commit, the date, the verdict and the Ship Score.
This command does not consume the quota: it is a read.
What PostShip does
Usage
postship ship --project <id> [--require] [--min-score <n>] [--json]Options
| Option | What it does |
|---|---|
--project, -p <id> | The project. |
--require | Exit 2 when no deploy is tracked — a CI that refuses to merge without proof of a ship. |
--min-score <n> | Exit 1 when the ship's score is below this threshold. |
--json | The raw response. |
Examples
postship ship -p 3f1c…One line: origin, commit, date, verdict, score.
postship ship -p 3f1c… --require --min-score 80In a workflow: production must have a ship, and it must be good.
Exit codes
0 · 1 failing ship or score below threshold · 2 no ship with --require, project not found, token, network.
Troubleshooting
“No production deployment tracked.”
No host is connected on this project, or no release has been seen yet. Project → Integrations.
See also
The postship command — every command, installation and sign-in · CI recipes — complete workflows to copy.
In the terminal, postship help ship says the same; postship docs ship opens this page.