Dry-run a POST /v1/runs body: will it be admitted, and what does it cost

Preview whether this exact body would be admitted by POST /v1/runs, returning {allowed, quota_cost, tier, rejection, resolved_order}.

This call SPENDS NOTHING: nothing is enqueued, no quota is reserved, and no Idempotency-Key is consumed (never send one here). quota_cost is the account's period upload cost of an accepted run, the same quota math GET /v1/account shows as period.used/period.cap, never a money figure. When allowed is false, rejection carries the exact typed error a real run would return (same code, hint, and retry_after_sec), so fix that before POST /v1/runs. Preflight validates request admissibility (source shape, plan entitlements, sandbox limits, quota, option bounds); it does not fetch the source object, so source_invalid or upload_too_large can still surface on the real run. Requires runs:write. Recover from a rejection by following rejection.hint; for service_unavailable or rate_limited, wait retry_after_sec and retry once.

post/runs/preflight

Request

  • Base URL: https://www.clipzyn.com/v1
  • URL: https://www.clipzyn.com/v1/runs/preflight
  • Auth: HTTP bearer

Request body

storage_pathstring nullable
source_urlstring nullable
top_ninteger
sub_clipsboolean
shortsboolean
midformboolean
midform_ninteger nullable
midform_requeststring nullable
trailerboolean
trailer_requeststring nullable
twitterboolean
twitter_ninteger nullable
twitter_requeststring nullable
carouselsboolean
carousels_ninteger nullable
carousels_requeststring nullable
clip_requeststring nullable
count_mode'exact' | 'engine' nullable
engine'standard' | 'deep' nullable

The cut to run: 'standard' (the normal cut) or 'deep' (the deep cut). Omit it for the default routing. 'deep' is refused with validation_error while the deep cut is switched off. Echoed as options_effective.engine.

titlestring nullable
host_namestring nullable
guest_namestring nullable
source_typestring
duration_secnumber nullable
pulse_recorded_atstring nullable
pulse_go_live_atstring nullable
pulse_episode_contextstring nullable
pulse_focus_topicsstring[] nullable
pulse_avoid_topicsstring[] nullable
pulse_source_published_atstring nullable

Response

Successful Response

allowedboolean required
quota_costinteger required
tierstring required

Changes

No recorded changes to this operation across all 1 revision of this API.