Introduction

The PromptLayer REST API lets you interact with your workspace directly over HTTP so you can automate updates, run workflows, log activity, and export or organize data from your own systems.

​

Authentication

Authenticate API requests with a PromptLayer API key using the X-API-Key header. Generate API keys from the API keys page in your PromptLayer dashboard. Each workspace has its own API keys, and requests use the workspace associated with the key by default.

​

Endpoints

​

Prompt Templates

• Get Prompt Template
• Get Prompt Template (Raw)
• List Prompt Templates
• Publish Prompt Template
• List Prompt Template Labels
• Create Prompt Template Label
• Move Prompt Template Label
• Delete Prompt Template Label
• Get Snippet Usage

​

Tracking

• Get Request
• Search Request Logs
• Log Request
• Track Prompt
• Track Score
• Track Metadata
• Create Spans Bulk
• Ingest Traces (OTLP)

​

Datasets

• List Datasets
• Get Dataset Rows
• Create Dataset Group
• Create Dataset Version from File
• Create Dataset Version from Filter Params

​

Evaluations

• List Evaluations
• Get Evaluation Rows
• Create Evaluation Pipeline
• Run Report
• Get Report
• Get Report Score
• Add Report Columns
• Edit Evaluation Pipeline Column
• Delete Evaluation Pipeline Column
• Update Report Score Card
• Rename Evaluation Pipeline
• Delete Evaluation Pipeline
• Delete Reports by Name

​

Tables

Table endpoints are scoped to the workspace associated with your API key. Sheet read responses include version_count; sheet mutations that create a new sheet version return version, the current sheet version count after the operation.

• Create Table
• List Tables
• Get Table
• Update Table
• List Sheets
• Create Sheet
• Import File
• Import Request Logs
• Get Sheet Import Operation
• Get Sheet
• Update Sheet
• List Columns
• Create Column
• Update Column
• List Rows
• Add Rows
• Get Cell
• Update Cell
• Recalculate Cell
• Recalculate Cells
• List Operations
• Create Operation
• Get Operation
• Cancel Operation
• Get Score
• Configure Score
• Recalculate Score
• List Versions
• Create Version
• Get Version
• Get Score History

​

Workflows

• List Workflows
• Create Workflow
• Update Workflow
• Run Workflow
• Get Workflow Version Execution Results

​

Skill Collections

• List Skill Collections
• Create Skill Collection
• Get Skill Collection
• Update Skill Collection
• Save Skill Collection Version

​

Unified Registry

• Create Folder
• Update Folder
• List Folder Entities
• Move Folder Entities
• Delete Folder Entities
• Resolve Folder ID by Path