Skip to main content
GET
List Tables
Retrieve Tables from the workspace associated with your API key.

Filtering

Use name for a case-insensitive partial title match and folder_id for registry folder membership. You can also filter to tables that contain prompt columns for a specific prompt_id, prompt_version_id, or prompt_label_id.

Pagination

This endpoint uses cursor pagination with cursor and limit. Results are sorted by created_at; use order=asc or order=desc to control direction. Tables are returned in data. Pagination metadata is returned in pagination, including next_cursor, has_more, and limit. Applied filters are returned in filters, and count is the number of Tables returned on the current page. Treat next_cursor as opaque. It includes the current sort, order, cursor value, and a hash of the active filters. Reuse a cursor only with the same sort, order, and filter parameters from the request that produced it; changing any of those while passing an old cursor returns an invalid cursor error.

Authorizations

X-API-KEY
string
header
required

Query Parameters

folder_id
integer

Filter by folder ID.

name
string

Filter by title (case-insensitive contains match).

cursor
string

Pagination cursor from a previous response.

limit
integer
default:20
Required range: 1 <= x <= 100
order
enum<string>
default:desc
Available options:
asc,
desc
prompt_id
integer

Filter to tables containing a column referencing this prompt.

prompt_version_id
integer
prompt_label_id
integer

Response

List of tables

data
object[]
next_cursor
string | null
has_more
boolean