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

# StartSessionOptions

***

# Interface: StartSessionOptions

Defined in: [src/types/logging/logger.types.ts](https://github.com/rungalileo/galileo-js/blob/main/src/types/logging/logger.types.ts)

Options for starting a new session.

## Properties

### externalId?

```ts theme={null}
optional externalId: string;
```

Defined in: [src/types/logging/logger.types.ts](https://github.com/rungalileo/galileo-js/blob/main/src/types/logging/logger.types.ts)

(Optional) An external identifier for the session. If a session with this external ID already exists, it will be reused instead of creating a new session.

***

### metadata?

```ts theme={null}
optional metadata: Record<string, string>;
```

Defined in: [src/types/logging/logger.types.ts](https://github.com/rungalileo/galileo-js/blob/main/src/types/logging/logger.types.ts)

(Optional) User metadata for the session as key-value string pairs. Only applied when creating a new session.

***

### name?

```ts theme={null}
optional name: string;
```

Defined in: [src/types/logging/logger.types.ts](https://github.com/rungalileo/galileo-js/blob/main/src/types/logging/logger.types.ts)

(Optional) The name of the session. Only applied when creating a new session.

***

### previousSessionId?

```ts theme={null}
optional previousSessionId: string;
```

Defined in: [src/types/logging/logger.types.ts](https://github.com/rungalileo/galileo-js/blob/main/src/types/logging/logger.types.ts)

(Optional) The ID of a previous session to link to. Creates a reference only; does not inherit metadata. Only applied when creating a new session.