--- title: "Get all chats from a connector exploration run (requires debug permission)" method: GET path: "/connectors/{connector_id}/explore/chat" tags: ["connectors"] --- # Get all chats from a connector exploration run (requires debug permission) `GET /connectors/{connector_id}/explore/chat` Returns chats for all phases (table discovery, column discovery for each table, etc.) ## Path parameters - `connector_id` string, uuid, required ## Query parameters - `run_id` string, required ## Response `200` Chats retrieved successfully - ExplorerChatResponse - `chats` ConnectorExplorerChat[], required - `chat_events` ChatEvent[], required - union — Events in a chat session timeline, including messages and unified tool calls/results - object - `TextMessage` object, required - `message` string, required - object - `Thinking` object, required - `block_id` integer, required - `complete` boolean, required - `content` string, required - object - `File` object, required — The file event can't be serialized to the database safely without the content. When streaming, we start with the path only, then add the content as we go. - `block_id` integer, required - `complete` boolean, required - `content` string, nullable - `path` string, required - object - `Action` object, required - `actions` ActionDef[], required - … - `block_id` integer, required - `complete` boolean, required - object - `Connector` object, required - `description` string, nullable - `env_vars` string[], required - `name` string, required - object - `ToolCall` object, required - `block_id` integer, required - `complete` boolean, required - `invocation` union, required - … - `tool_result` union, required - … - object - `Question` object, required - `block_id` integer, required - `complete` boolean, required - `content` string, required - `options` string[], required - object - `InternalError` object, required - `message` string, required - object - `ReviewRequest` object, required - `node_summaries` NodeSummary[], required - … - object - `AttachedFile` object, required - `image_bytes` string, binary, nullable - `path` string, required - object - `ConnectorRequest` object, required - `connector_id` string, uuid, required - `chat_prompt` ChatPrompt, required - `decoding_params` DecodingParams, required - `parameters` DecodingParamEnum[], required - union - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - `messages` Message[], required - `content` MessageContent[], required — We want this to be a vec of contents so we can accurately capture an interleaving of images and text. This is meant to be a completely raw, unprocessed representation of the text. Don't take stuff out. - union - object - … - object - … - `role` 'user' | 'system' | 'assistant', required - `metadata` PromptMeta, required — All metadata required to generate a prompt for the LLM - `dataset_descriptor` DatasetDescriptor, required — A dataset is where you put multiple referential schemas. A dataset is a complete namespace where all references between schemas are held within the dataset. - `description` string, required - `llm_override_field` string, nullable - `name` string, required - `relationships` RelationshipDescriptor[], required - `description` string, required - `merge_strategy` RelationshipMergeStrategy - … - `name` string, required - `properties` PropertyDescriptor[] - … - `source_table` string, required - `target_table` string, required - `tables` TableDescriptor[], required - `description` string, required - `expected_cardinality` integer, nullable — Expected number of unique values in the complete dataset. This is used for our probabilistic merge strategy. - `name` string, required — Organized in a name, description format. - `primary_column` string, nullable - `properties` PropertyDescriptor[], required — Organized in a name, description format. - … - `extracted_entities` LLMKnowledgeGraph[], required - `entities` LLMEntity[], required - `id` integer, required - `properties` object, required - `type` string, required - `relationships` LLMRelationship[] - `properties` object - `source` integer, required - `target` integer, required - `type` string, required - `extraction_criteria` SaveRequirement[], required - union — It's an OR statement across these. - RequiredRelationship - … - RequiredEntity - … - RequiredProperty - … - `formatter_specific` union, required - object - `ImageMeta` ImageMeta, required - … - object - `WebMeta` WebMeta, required - … - object - `TextMeta` TextMeta, required - … - object - `ScraperMeta` ScraperMeta, required - … - `qa_potentially_sus_response` string, nullable - `tool_metadata` ToolMetadata[], required - `description` string, required - `name` 'Exit' | 'Save' | 'Wait' | 'Type' | 'Scroll' | 'ScrollToBottom' | 'Click' | 'Hover' | 'Error' | 'Google', required - `regex_validator` string, required - `connector_id` string, uuid, required - `created_at` string, date-time, required - `exploration_run_id` string, uuid, required - `id` string, uuid, required - `phase_id` union, required — Identifies the phase of connector exploration This enum is used to track which phase of exploration a chat session belongs to. It's stored as JSONB in the database to allow for flexible phase identification. - object — First phase: discovering all databases in the connector - `connector_id` string, uuid, required - `type` 'discover_databases', required - object — Second phase: discovering all schemas in a database - `database_id` string, uuid, required - `database_name` string, required - `type` 'discover_schemas', required - object — Third phase: discovering all tables in a schema - `schema_id` string, uuid, required - `schema_name` string, required - `type` 'discover_tables', required - object — Fourth phase: discovering columns for a specific table - `table_id` string, uuid, required - `table_name` string, required - `type` 'discover_columns', required - object — Initial phase: discovering all API resources - `connector_id` string, uuid, required - `type` 'discover_api_resources', required - object — Second phase: discovering fields for a specific API resource - `resource_name` string, required - `table_id` string, uuid, required - `type` 'discover_api_fields', required ## Other responses - `400` — Bad request - missing or invalid run_id - `403` — Forbidden - user does not have debug permission - `404` — Connector not found ## Changes - **2026-01-23** `58eb8eebcd42` — 1 breaking - added `subschema #10, subschema #11` to the `chats/items/chat_events/items/` response property `oneOf` list for the response status `200` - **2026-01-23** `1855c07e8f06` — 1 info - added the required property `chats/items/chat_events/items/oneOf[subschema #9]/ReviewRequest/node_summaries/items/in_dashboard` to the response with the `200` status - **2026-01-22** `7ea3670b144a` — 1 breaking, 1 info - added `subschema #10, subschema #11` to the `chats/items/chat_events/items/oneOf[subschema #6]/ToolCall/tool_result` response property `oneOf` list for the response status `200` - removed `subschema #5` from the `chats/items/chat_events/items/oneOf[subschema #6]/ToolCall/tool_result` response property `oneOf` list for the response status `200` - **2026-01-16** `4976f196c8f3` — 1 breaking, 1 info - added `subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10` to the `chats/items/chat_events/items/oneOf[subschema #6]/ToolCall/invocation` response property `oneOf` list for the response status `200` - removed `subschema #2` from the `chats/items/chat_events/items/oneOf[subschema #6]/ToolCall/invocation` response property `oneOf` list for the response status `200` - …earlier changes not shown [Full history](https://skmtc.dev/structifyai/apis/structify/changes/connectors/:connector_id/explore/chat/get.md) --- [API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)