Create Sheet
Create a new sheet in a table. Omit source to create a blank sheet with a default Column A scaffold (returns 201), or import data from a file (CSV or JSON, base64-encoded) or from request log history (returns 202). Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.
- Empty sheet — Omit
sourceto create a blank sheet with a defaultColumn Atext column and one empty row. Returns 201 immediately. Use this when you want to add columns and rows incrementally via the Create Column and Add Rows endpoints. - file — Upload a CSV or JSON file (base64-encoded, max 100 MB). The import runs asynchronously; poll the operation endpoint to track progress. Returns 202.
- request_logs — Import from your PromptLayer request history. Filter by prompt, version, label, or date range. Returns 202.
source is omitted, operation_id is not allowed. When importing from a file or request logs, operation_id is optional for idempotency and status tracking.Authorizations
Path Parameters
Body
Sheet title. Defaults to 'Sheet N' when source is omitted, or to the source file name / 'Request Logs' for imports.
Display position within the table (0-based). Defaults to appending at the end.
Optional idempotency key for import operations. Not allowed when source is omitted.
Optional data source for the sheet. Omit to create a blank sheet with a default Column A scaffold.
- File source
- Request logs source

