---
title: "Chat Dataset"
method: POST
path: "/api/v0/chat/dataset/{dataset_id}"
tags: ["agentic-search > agenticSearch"]
---

# Chat Dataset

`POST /api/v0/chat/dataset/{dataset_id}`

Chat endpoint that processes user input with LLM and MCP video search integration for a specific dataset.

## Path parameters

- `dataset_id` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- AgenticSearchChatRequest — Request schema for chat endpoint.
  - `chat_request_text` string, nullable — User's chat input text
  - `upload_id` string, nullable — Upload ID of the user's input image
  - `history_chat_messages` object[], nullable — Conversation history (does not include current message)

## Response `200`

Successful Response

- AgenticSearchChatResponse — Response schema for chat endpoint.
  - `chat_response_text` string, required — LLM response text
  - `tool_results` AgenticSearchToolResult[], required — Results from MCP tools invoked during this request.
    - `tool_name` 'video_search_search_videos' | 'video_search_get_video_details' | 'apollo_search_image_to_image' | 'apollo_search_image_to_keyframes' | 'apollo_search_hybrid_search' | 'apollo_search_transcript_exact_match' | 'apollo_search_audio_search' | 'apollo_search_audio_sound_search' | 'apollo_search_text_to_image_search_by_person' | 'metadata_filter_search_text_to_video_with_metadata_filters' | 'metadata_filter_search_text_to_transcript_with_metadata_filters' | 'metadata_filter_search_audio_sound_with_metadata_filters' | 'metadata_filter_search_text_to_image_with_metadata_filters', required — Enum of available MCP tool names.
    - `dataset_id` string, uuid, required — ID of the dataset that the tool was invoked for
    - `dataset_type` 'native_video' | 'legacy', required — Dataset type enum.
    - `invocation_timestamp` string, required — Timestamp of the MCP tool invocation (ISO 8601 format)
    - `result` union, required — Result from the MCP tool invocation
      - AgenticSearchVideoSearchResponse — Response schema for search_videos tool.
        - `results` AgenticSearchVideoSearchResultItem[]
          - `dataset_id` string, uuid, required
          - `text_query` string, required
          - `video_id` string, uuid, required
          - `source_path` string, required
          - `video_score` number, double, nullable
          - `metadata` union
            - AgenticSearchVideoMetadata — Metadata associated with a video.
              - …
            - object
          - `top_composite_slice` AgenticSearchCompositeSlice — Composite slice details (used by both video search and transcript matching).
            - `id` string, uuid, required
            - `index` integer, nullable
            - `start_frame_num` integer, nullable
            - `end_frame_num` integer, nullable
            - `start_time_ms` integer, nullable
            - `end_time_ms` integer, nullable
            - `composite_id` string, uuid, nullable
            - `composite_type` string, required
          - `top_keyframe` AgenticSearchVideoKeyframe — Video keyframe details.
            - `id` string, uuid, required
            - `frame_time_ms` integer, nullable
          - `moderation_score` number, double, nullable
      - AgenticSearchImageKeyframeSearchResponse — Response schema for image and keyframe search tools.
        - `data` AgenticSearchImageKeyframeSearchResultItem[]
          - `coactive_image_id` string, uuid, required
          - `path` string, nullable
          - `metadata` object, nullable
          - `moderation_score` number, double, nullable
          - `video` AgenticSearchVideo — Video asset metadata.
            - `coactive_video_id` string, uuid, required
            - `path` string, nullable
            - `metadata` object, nullable
          - `shot` AgenticSearchShot — Metadata about a video shot.
            - `shot_id` string, uuid, required
            - `start_time_ms` integer, required
            - `end_time_ms` integer, required
          - `audio_segment` AgenticSearchAudioSegment — Metadata about a video audio segment.
            - `start_time_ms` integer, required
            - `end_time_ms` integer, required
            - `speech_to_text_transcription` string, required
          - `timestamp` integer, nullable
      - AgenticSearchKeyframeSearchResponse — Response schema for keyframe search tool.
        - `data` AgenticSearchKeyframeSearchResultItem[]
          - `keyframe_id` string, uuid, required
          - `score` number, double, required
          - `asset_type` string, required
          - `dataset_id` string, uuid, required
          - `video_id` string, uuid, required
          - `composite_slice_id` string, uuid, nullable
          - `moderation_score` number, double, nullable
      - AgenticSearchTranscriptExactMatchResponse — Response schema for apollo_search_transcript_exact_match tool.
        - `data` AgenticSearchVideoTranscriptMatch[]
          - `coactive_image_id` string, uuid, required
          - `video` AgenticSearchVideo, required — Video asset metadata.
            - `coactive_video_id` string, uuid, required
            - `path` string, nullable
            - `metadata` object, nullable
          - `audio_segment` AgenticSearchAudioSegment, required — Metadata about a video audio segment.
            - `start_time_ms` integer, required
            - `end_time_ms` integer, required
            - `speech_to_text_transcription` string, required
          - `coverage_score` number, double, nullable
          - `timestamp` integer, nullable
          - `moderation_score` number, double, nullable
      - AgenticSearchHybridSearchResponse — Response schema for hybrid search tool.
        - `data` AgenticSearchHybridSearchResultItem[]
          - `coactive_image_id` string, uuid, required
          - `path` string, nullable
          - `metadata` object, nullable
          - `moderation_score` number, double, nullable
          - `relevance_score` number, double, required
      - AgenticSearchGetVideoDetailsResponse — Response schema for get_video_details tool.
        - `dataset_id` string, uuid, required
        - `text_query` string, required
        - `video_id` string, uuid, required
        - `composite_type` string, required
        - `source_path` string, required
        - `slices` AgenticSearchCompositeSliceWithScore[]
          - `id` string, uuid, required
          - `index` integer, nullable
          - `start_frame_num` integer, nullable
          - `end_frame_num` integer, nullable
          - `start_time_ms` integer, nullable
          - `end_time_ms` integer, nullable
          - `composite_id` string, uuid, nullable
          - `composite_type` string, required
          - `composite_slice_score` number, double, nullable
      - AgenticSearchTextToImageSearchByPersonResponse — Response schema for text_to_image_search_by_person tool.
        - `data` AgenticSearchTextToImageSearchByPersonResultItem[]
          - `coactive_image_id` string, uuid, required
          - `asset_type` string, required
          - `dataset_id` string, uuid, required
          - `video_id` string, uuid, nullable
          - `composite_slice_id` string, uuid, nullable
          - `composite_type` string, nullable
          - `composite_start_time_ms` integer, nullable
          - `composite_end_time_ms` integer, nullable
          - `moderation_score` number, double, nullable
        - `videos` AgenticSearchTextToImageSearchByPersonVideoResult[]
          - `video_id` string, uuid, required
          - `moderation_score` number, double, nullable
      - AgenticSearchMetadataFilterTriggerResponse — All metadata-filter search tools now return an async job run_id.
        - `run_id` integer, required
      - AgenticSearchAudioSoundSearchResponse — Response schema for apollo_search_audio_sound_search tool.
        - `data` AgenticSearchAudioChunk[]
          - `coactive_image_id` string, uuid, required
          - `video` AgenticSearchVideo, required — Video asset metadata.
            - `coactive_video_id` string, uuid, required
            - `path` string, nullable
            - `metadata` object, nullable
          - `start_time_ms` integer, required
          - `end_time_ms` integer, required
          - `score` number, double, required
          - `timestamp` integer, nullable
          - `moderation_score` number, double, nullable
  - `history_chat_messages` object[], required — Conversation history (includes current message)
  - `suggested_follow_ups` string[], required — Suggested follow-up messages to continue the conversation

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)