FWfw-ai-external
gateway.openapi_Gateway

Create a training session under an account.

Changed on
post/v1/accounts/{account_id}/trainingSessions

Request

Path parameters

account_idstring required

The Account Id

Query parameters

trainingSessionIdstring

Request body

namestring
displayNamestring

Human-readable display name of the training session. e.g. "Training session" Must be fewer than 64 characters long.

createTimestring date-time
updateTimestring date-time
state'TRAINING_SESSION_STATE_UNSPECIFIED' | 'READY' | 'FAILED' | 'DELETING' | 'EXPIRED'

AIP-216 lifecycle. DELETING is observable when DeleteTrainingSession releases the shared-trainer binding before the row is removed; Create is synchronous today and lands in READY directly, so no CREATING value is declared until an async Create path actually emits it (minimal-surface rule).

createdBystring
referenceState'TRAINING_SESSION_REFERENCE_STATE_UNSPECIFIED' | 'BASE' | 'ADAPTER'

ReferenceState indicates whether the session currently references the base model or a loaded LoRA adapter. Updated automatically when LoadTrainingSessionState is called.

  • BASE: Session is using the base model (no adapter loaded).
  • ADAPTER: Session has a LoRA adapter loaded.
baseModelstring

Base model resource name (accounts/{a}/models/{m}). Supplied at create_model (bind), not at create_session (reserve) — so OPTIONAL at the wire level and set-once / IMMUTABLE thereafter.

Response

A successful response.

namestring
displayNamestring

Human-readable display name of the training session. e.g. "Training session" Must be fewer than 64 characters long.

createTimestring date-time
updateTimestring date-time
state'TRAINING_SESSION_STATE_UNSPECIFIED' | 'READY' | 'FAILED' | 'DELETING' | 'EXPIRED'

AIP-216 lifecycle. DELETING is observable when DeleteTrainingSession releases the shared-trainer binding before the row is removed; Create is synchronous today and lands in READY directly, so no CREATING value is declared until an async Create path actually emits it (minimal-surface rule).

createdBystring
referenceState'TRAINING_SESSION_REFERENCE_STATE_UNSPECIFIED' | 'BASE' | 'ADAPTER'

ReferenceState indicates whether the session currently references the base model or a loaded LoRA adapter. Updated automatically when LoadTrainingSessionState is called.

  • BASE: Session is using the base model (no adapter loaded).
  • ADAPTER: Session has a LoRA adapter loaded.
baseModelstring

Base model resource name (accounts/{a}/models/{m}). Supplied at create_model (bind), not at create_session (reserve) — so OPTIONAL at the wire level and set-once / IMMUTABLE thereafter.

Changes