---
title: "Create Chat Session"
method: POST
path: "/v0/chat_sessions/chat_results"
tags: ["chat_session"]
---

# Create Chat Session

`POST /v0/chat_sessions/chat_results`

## Request body

- CreateChatSessionWithChatResultInput
  - `integration_id` string, required
  - `chat_session` ChatSessionInput, required
    - `guidance` string, nullable
    - `context` string, nullable
    - `messages` Message[], required
      - union
        - UserMessage
          - `role` 'user', required
          - `content` string, required
        - AssistantMessage
          - `role` 'assistant', required
          - `content` string, required
          - `records_cited` RecordsCited
            - `citations` Citation[], required
              - …
    - `tags` string[]
  - `chat_mode` union
    - 'turbo' | 'auto'
    - string
  - `stream` boolean

## Response `200`

Successful Response

- ChatResult
  - `chat_session_id` string, required
  - `message` AssistantMessage, required
    - `role` 'assistant', required
    - `content` string, required
    - `records_cited` RecordsCited
      - `citations` Citation[], required
        - `number` integer
        - `record` Record, required
          - `type` union, required — The type of record
            - 'documentation' | 'site' | 'discourse_post' | 'github_issue' | 'github_discussion' | 'stackoverflow_question' | 'discord_forum_post' | 'discord_message' | 'custom_question_answer'
            - string
          - `url` string, nullable
          - `title` string, nullable
          - `description` string, nullable
          - `breadcrumbs` string[], nullable
        - `hit_url` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/inkeep/apis/inkeep-search-and-chat-api.md) · [All operations](https://skmtc.net/inkeep/apis/inkeep-search-and-chat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inkeep/inkeep-search-and-chat-api/versions/18384b1ef7b1/schema)