---
title: "GET /connectors/search-tables"
method: GET
path: "/connectors/search-tables"
tags: ["connectors"]
---

# GET /connectors/search-tables

`GET /connectors/search-tables`

## Query parameters

- `team_id` string, uuid, required
- `query` string, required

## Response `200`

List of table mentions

- TableSearchResults
  - `ranked_results` ConnectorTableSearchResult[], required
    - `columns` ConnectorColumn[], required
      - `name` string, required — Name of the column
      - `notes` string, nullable — Additional notes about the column
      - `type` string, required — SQL type of the column (e.g., "VARCHAR(255)", "INTEGER") or API field type
    - `database_name` string, required
    - `schema_name` string, required
    - `score` number, double, required — Search relevance score (0 = exact match, higher = less relevant)
    - `table` ConnectorTable, required — Represents a table (for relational databases) or resource (for APIs)
      - `columns` ConnectorColumn[], required — List of columns in this table/resource
        - `name` string, required — Name of the column
        - `notes` string, nullable — Additional notes about the column
        - `type` string, required — SQL type of the column (e.g., "VARCHAR(255)", "INTEGER") or API field type
      - `description` string, nullable — Optional description
      - `endpoint` string, nullable — API endpoint (None for relational DB tables, Some for API resources)
      - `id` string, uuid, required
      - `name` string, required — Name of the table or resource
      - `notes` string, nullable — Optional notes
  - `raw_results` ConnectorTableSearchResult[], required
    - `columns` ConnectorColumn[], required
      - `name` string, required — Name of the column
      - `notes` string, nullable — Additional notes about the column
      - `type` string, required — SQL type of the column (e.g., "VARCHAR(255)", "INTEGER") or API field type
    - `database_name` string, required
    - `schema_name` string, required
    - `score` number, double, required — Search relevance score (0 = exact match, higher = less relevant)
    - `table` ConnectorTable, required — Represents a table (for relational databases) or resource (for APIs)
      - `columns` ConnectorColumn[], required — List of columns in this table/resource
        - `name` string, required — Name of the column
        - `notes` string, nullable — Additional notes about the column
        - `type` string, required — SQL type of the column (e.g., "VARCHAR(255)", "INTEGER") or API field type
      - `description` string, nullable — Optional description
      - `endpoint` string, nullable — API endpoint (None for relational DB tables, Some for API resources)
      - `id` string, uuid, required
      - `name` string, required — Name of the table or resource
      - `notes` string, nullable — Optional notes
  - `rerank_scores` RerankResult[], required
    - `index` integer, required
    - `relevance_score` number, float, required
    - `text` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - user does not have access to team

---

[API](https://skmtc.net/structifyai/apis/structify.md) · [All operations](https://skmtc.net/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/structifyai/structify/versions/1364930b6980/schema)