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

# startTurn

> TypeScript SDK reference

# startTurn

▸ **startTurn**(`opts?`): [`Turn`](../classes/turn)

Start a new Turn. If a Conversation is active, the turn inherits its
`conversationId`; otherwise the turn has no conversation id.

#### Parameters

| Name   | Type                                 |
| :----- | :----------------------------------- |
| `opts` | [`TurnInit`](../interfaces/turninit) |

#### Returns

[`Turn`](../classes/turn)

`Example`

```ts twoslash theme={null}
// @noErrors
weave.startTurn({agentName: 'research-bot'});
```

`Example`

```ts twoslash theme={null}
// @noErrors
weave.startTurn({
  agentName: 'research-bot',
  startTime: new Date('2026-05-29T10:00:00.000Z'),
});
```

#### Defined in

[src/genai/api.ts:48](https://github.com/wandb/weave/blob/9591aba8a5e77309ee0858e5ba94d31c1bd7e404/sdks/node/src/genai/api.ts#L48)

***