Chat | Coactive AI

{
  "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 select datasets in the org. Please contact Coactive Support to configure the datasets required.

Authentication

AuthorizationBearer

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

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