Chat Dataset | Coactive AI

curl -X POST https://api.coactive.ai/api/v0/chat/dataset/dataset_id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "chat_response_text": "string",
  "tool_results": [
    {
      "tool_name": "video_search_search_videos",
      "dataset_id": "string",
      "dataset_type": "native_video",
      "invocation_timestamp": "string",
      "result": {
        "results": [
          {
            "dataset_id": "string",
            "text_query": "string",
            "video_id": "string",
            "source_path": "string",
            "video_score": 1.1,
            "metadata": {
              "data": {}
            },
            "top_composite_slice": {
              "id": "string",
              "index": 1,
              "start_frame_num": 1,
              "end_frame_num": 1,
              "start_time_ms": 1,
              "end_time_ms": 1,
              "composite_id": "string",
              "composite_type": "string"
            },
            "top_keyframe": {
              "id": "string",
              "frame_time_ms": 1
            },
            "moderation_score": 1.1
          }
        ]
      }
    }
  ],
  "history_chat_messages": [
    {}
  ],
  "suggested_follow_ups": [
    "string"
  ]
}

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

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

dataset_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

chat_request_textstring or nullOptional

User's chat input text

upload_idstring or nullOptional

Upload ID of the user's input image

history_chat_messageslist of maps from strings to any or nullOptional

Conversation history (does not include current message)

Response

Successful Response

chat_response_textstring

LLM response text

tool_resultslist of objects

Results from MCP tools invoked during this request.

history_chat_messageslist of maps from strings to any

Conversation history (includes current message)

suggested_follow_upslist of strings

Suggested follow-up messages to continue the conversation

Errors

422

Unprocessable Entity Error