---
title: stack kb security-ai-assistant-api create-conversation cli command
description: Create a conversation Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://docs-v3-preview.elastic.dev/elastic/cli/pull/525/cli/stack/kb/security-ai-assistant-api/create-conversation
---

# stack kb security-ai-assistant-api create-conversation cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack kb security-ai-assistant-api create-conversation \
  --title <title> \
  [options]
```

Create a conversation
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--title string required">
    The conversation title.
  </definition>
  <definition term="--api-config string">
    LLM API configuration.
  </definition>
  <definition term="--category enum">
    The conversation category.
    **Values:** assistant, insights
  </definition>
  <definition term="--[no-]exclude-from-last-conversation-storage">
    Exclude from last conversation storage.
  </definition>
  <definition term="--id string">
    The conversation id.
  </definition>
  <definition term="--messages string[]">
    The conversation messages.
  </definition>
  <definition term="--replacements string">
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--[no-]dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--[no-]json">
    output as JSON
  </definition>
</definitions>