Suspend an active number
Temporarily suspend an active number — stop inbound routing and outbound use WITHOUT releasing the DID back to inventory. Only a number in active status can be suspended; suspending a released / parked / pending number returns 409. The row flips to suspended and every inbound resolver + outbound from-number gate (which already whitelist status='active') stops routing immediately. Org-ownership is enforced per call so a sibling sub-org sharing the tenant schema cannot pause a number it does not own. The inverse of POST /api/v1/numbers/{id}/reactivate. Scoped on numbers:write (owner / admin / developer).
Authorizations
Dashboard JWT token from Clerk
Path Parameters
Body
Optional free-text suspension note, persisted to the lifecycle audit fields.
500