Sign in
preview-deployments

Make one fine-tuned version testable

Prepare one exact version for testing without changing live routing.

Args: project_id: Project the version belongs to. request: The exact version to prepare. auth: Authenticated caller.

Returns: The state to render now: already ready, already in flight, or newly provisioning.

post/projects/{project_id}/preview-deployments

Path parameters

project_idstring uuid required

Request body

training_job_idstring uuid required

UUID of the exact fine-tuned version to prepare. Always a training job, never a project: a preview targets one artifact, not whatever the project currently routes to.

Response

Successful Response

training_job_idstring required

The exact version this status describes.

state'ready' | 'warming' | 'provisioning' | 'inactive' | 'failed' | 'unavailable' required

What a caller can do with an exact fine-tuned version right now.

detailstring required

Customer-safe explanation of the state.

can_send_requestsboolean required

Whether an inference request against this version will be answered now. True for ready and warming -- a warming version is routable and the request itself brings the replica up, so the pane should send rather than wait for a state that only a request can advance.

reason'project_mismatch' | 'job_deleted' | 'job_incomplete' | 'job_failed' | 'job_cancelled' | 'missing_artifact' | 'provider_incompatible'

Why a training job may not be promoted to serve traffic.

retry_after_secondsinteger nullable

How long to wait before polling again; set only for transient states.

can_activateboolean required

Whether this caller may trigger provisioning. False for members without the deploy permission, so the UI shows a truthful unavailable state instead of a button the server would reject.

attempt_countinteger required

How many activations have been requested for this version.

retry_exhaustedboolean

Whether repeated failures have used up this version's retry budget. When true the state is failed but activation will be refused, so the UI should stop offering a retry and point at the version instead.

Changes