List Tables

List Smart Tables in the workspace. Supports cursor-based pagination and optional filtering by folder or prompt column.

GET /api/public/v2/tables

List Tables

cURL

curl --request GET \
  --url https://api.promptlayer.com/api/public/v2/tables \
  --header 'X-API-KEY: <api-key>'

200

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workspace_id": 123,
      "title": "<string>",
      "folder_id": 123,
      "sheet_count": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>",
  "has_more": true
}

List Smart Tables in the workspace. Supports cursor-based pagination. Filter by folder, title, or by prompt columns that reference specific prompts.

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

200

application/json

List of tables

data · object[]

Show child attributes

next_cursor · string | null

has_more · boolean