> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baseten.co/llms.txt
> Use this file to discover all available pages before exploring further.

# baseten train job session

> Inspect a training job's interactive sessions

## describe

```sh theme={"system"}
baseten train job session describe [OPTIONS]
```

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

<ParamField body="--job-id" type="TEXT" required>
  ID of the training job.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Show a job's interactive sessions

```sh theme={"system"}
baseten train job session describe --job-id p7qr9qv
```

### Filter output with `--jq`

Print the first replica's auth URL

```sh theme={"system"}
baseten train job session describe --job-id p7qr9qv --jq '.auth_codes[0].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`.