Record per-carrier vetting for a short-code application
Record a carrier’s vetting decision for an SMS short-code application. The first vetting signal moves the application from submitted to carrier_vetting and seeds the per-carrier tracker (the US carriers for a US code); later calls update a single carrier’s state within the multi-week review. Use it to relay each carrier’s pending / approved / rejected decision so the timeline reflects real progress. Returns 409 if the application is not submitted or under review, and 404 if no application with that id belongs to the caller’s organization. Requires the numbers:write scope (owner / admin).
Authorizations
Dashboard JWT token from Clerk
Headers
Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.
1 - 255Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Path Parameters
Resource identifier
1Body
The carrier's vetting decision to record.