---
title: "POST /api/datasources/preview_sql_table_list"
method: POST
path: "/api/datasources/preview_sql_table_list"
---

# POST /api/datasources/preview_sql_table_list

`POST /api/datasources/preview_sql_table_list`

## Headers

- `Marimo-Session-Id` string, required

## Request body

- ListSQLTablesRequest
  - `database` string, required
  - `engine` string, required
  - `requestId` string, request-id, required
  - `schema` string, required
  - `schemaPath` string[]

## Response `200`

Preview a list of tables in an SQL schema

- SuccessResponse
  - `success` boolean

## Changes

> 60 revisions in range; 3 could not be searched.

- **2026-06-22** `507e113c52c5` — 1 info
  - added the new optional request property `schemaPath`
- **2026-03-31** `41bba414df27` — 1 breaking
  - the `requestId` request property type/format changed from `string`/`` to `string`/`request-id`
- **2026-03-18** `f29fa637d35b` — 1 warning, 1 info
  - removed the request property `schemaPath`
  - the `requestId` request property type/format was generalized from `string`/`request-id` to `string`/``

[Change history](https://skmtc.dev/marimo-team/apis/marimo-api/changes/api/datasources/preview_sql_table_list/post.md)

---

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