Add a member to a shared line
Add one member to the line’s ringing roster. A sip_extension member targets an org SIP credential username; a user_id member targets an auth user id. canGrab (default true) decides whether this member may pull the answered call onto their device via /:id/grab. When sortOrder is omitted the server assigns the next position. The roster is capped; exceeding it returns 409. Requires owner/admin/developer.
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
Shared line id.
1Body
Whether memberValue is interpreted as a SIP extension username (sip_extension, default) or an auth user id (user_id).
sip_extension, user_id The extension username or user id to ring on inbound calls.
1 - 128Whether this member may grab the answered call via /:id/grab (default true).
Ring preference order (0–999). Omitted = appended after the current roster.
0 <= x <= 999Response
Created — the resource was created successfully.
The response is of type object.