Suggest segment rules from a prompt (AI, no persist)
AI segment builder (suggest-only): translate a natural-language description into the segment evaluator’s { field, operator, value } rule vocabulary and return the derived operator + flattened rules WITHOUT persisting a segment. This is a direct API/integration primitive for callers that only want the suggested rules; the Orbit dashboard’s own “Suggest” action calls the combined POST /segments/autopilot endpoint instead, which returns the same suggestion plus a live match-count preview in one round-trip, so it intentionally has no dashboard UI caller of its own. Returns 503 when no LLM provider is configured. Unlike POST /segments/from-prompt, this persists nothing.
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 Body
Natural-language description of the audience (1-2000 chars).