Skip to main content
POST
/
api
/
public
/
v2
/
tables
Create Table
curl --request POST \
  --url https://api.promptlayer.com/api/public/v2/tables \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "title": "<string>",
  "folder_id": 123
}
'
{
  "success": true,
  "message": "<string>",
  "table": {
    "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",
    "sheet_row_counts": {}
  }
}
Create a Table with a default Sheet 1, a Column A text column, and one empty row.

​
Workspace and folders

The table is created in the workspace associated with your API key. Pass folder_id to create the table inside a registry folder in that workspace. When title is omitted, PromptLayer generates an Untitled Table name.

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
title
string | null

Table title. Defaults to a unique 'Untitled Table' name if omitted.

​
folder_id
integer | null

Folder to place the table in.

Response

Table created

​
success
boolean
​
message
string
​
table
object

A Table — a versioned, multi-sheet table that can run LLM columns to generate or evaluate data at scale.