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 all columns in a sheet, ordered by their position rank. Each column has a type that determines how its cells are populated:
  • text — Free-text cells, editable directly.
  • prompt_template, llm, code, score, comparison, composition — Computed columns that run automatically.

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