Introduction

Use the PromptLayer REST API to manage prompts, workflows, evaluations, datasets, request logs, traces, and other workspace resources programmatically.

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

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