Skip to main content
GET
/
api
/
public
/
v2
/
tables
/
{table_id}
/
sheets
/
{sheet_id}
/
columns
List Columns
curl --request GET \
  --url https://api.promptlayer.com/api/public/v2/tables/{table_id}/sheets/{sheet_id}/columns \
  --header 'X-API-KEY: <api-key>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sheet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workspace_id": 123,
      "title": "<string>",
      "config": {},
      "position_rank": 123,
      "is_output_column": true
    }
  ],
  "next_cursor": "<string>",
  "has_more": true
}
List columns for a Table sheet using cursor pagination. Results are sorted by position_rank; use order=asc or order=desc to control direction. Columns are returned in sheet order and include dependency and source metadata for clients that need to render or recreate column configuration. Columns are returned in data. Pagination metadata is returned in pagination, including next_cursor, has_more, and limit. 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

Path Parameters

​
table_id
string<uuid>
required
​
sheet_id
string<uuid>
required

Query Parameters

​
include_system_columns
boolean
default:false

When true, include system-managed metadata columns such as price and latency columns for prompt-template outputs.

​
cursor
string
​
limit
integer
default:100
Required range: 1 <= x <= 100

Response

List of columns

​
data
object[]
​
next_cursor
string | null
​
has_more
boolean