Mint a draft re-pinned to the successor model
One-click repin of the agent’s PRIMARY pinned model to the catalog’s recommended successor: mints a draft version with model set to the successor and returns the version id plus the exact promote URL. Only the primary model can be repinned here — fallback-chain entries and config.model_routing tiers are edited through the agent config update path. The promotion gate runs on the returned promote call, not here. 404 when the agent or advisory model id is unknown. Owner, admin, or developer role.
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 Response
Successful response.