spec0 diff

Diff two specs: each side is a file path or registry ref org/api[@tag] (latest if tag omitted)

Auto-generated from spec0 commands --output=json. Do not edit by hand — changes are overwritten by npm run sync:cli-docs.

Usage

spec0 diff <a> <b> [options]

name	required	description
`a`	yes	Left: local path or org/api[@tag]
`b`	yes	Right: local path or org/api[@tag]

flag	description	default
`--breaking-only`	Show breaking changes only (via backend oasdiff service)
`--org <uuid>`	Org id override for registry fetches

Stable contract — branch on these from CI and agents.

code	meaning
0	success
1	generic / unclassified failure
2	usage error (bad flags, missing args)
3	not authenticated (no token / token expired)
4	permission denied (403)
5	resource not found (404)
6	conflict (409 — e.g. name already taken)
7	validation failed (422 — e.g. spec below min score)
8	rate limited (429)
9	upstream server error (5xx)
10	network error (unreachable, timeout)