Skip to main content

describe

Describe the interactive sessions of a training job, one per replica. Only replicas with a live session are listed, so a job whose session has not started yet reports none.

Options

TEXT
required
ID of the training job.
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
BOOL
Enable verbose logging

Examples

Show a job’s interactive sessions

Filter output with --jq

Print the first replica’s auth URL

Output

Text mode (--output text): Table with columns: REPLICA, SESSION, AUTH URL, EXPIRES. When no session is live, prints “No interactive sessions found.” to stderr. JSON mode (--output json): payload type managementapi.GetAuthCodesResponse.