> ## Documentation Index
> Fetch the complete documentation index at: https://promptlayer-cursor-pro-216-issue-resolution-task-2ba1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Note>
  Prefer a client library? See the [Python SDK](/sdks/python) and [JavaScript SDK](/sdks/javascript). The complete machine-readable spec is available at [openapi.json](https://docs.promptlayer.com/openapi.json).
</Note>

## 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](/reference/templates-get)
* [Get Prompt Template (Raw)](/reference/templates-get-raw)
* [List Prompt Templates](/reference/list-prompt-templates)
* [Publish Prompt Template](/reference/templates-publish)
* [Patch Prompt Template Version](/reference/templates-patch)
* [List Prompt Template Labels](/reference/templates-labels-get)
* [Create Prompt Template Label](/reference/prompt-labels-create)
* [Move Prompt Template Label](/reference/prompt-labels-patch)
* [Delete Prompt Template Label](/reference/prompt-labels-delete)
* [Get Snippet Usage](/reference/get-snippet-usage)

### Tracking

* [Get Request](/reference/get-request)
* [Search Request Logs](/reference/search-request-logs)
* [Log Request](/reference/log-request)
* [Track Prompt](/reference/track-prompt)
* [Track Score](/reference/track-score)
* [Track Metadata](/reference/track-metadata)
* [Create Spans Bulk](/reference/spans-bulk)
* [Ingest Traces (OTLP)](/reference/otlp-ingest-traces)
* [Get Trace](/reference/get-trace)
* [Close Trace](/reference/close-trace)
* [Request Analytics](/reference/request-analytics)
* [Request Analytics — Custom Queries](/reference/request-analytics-custom-analytics)
* [Search Request Suggestions](/reference/search-request-suggestions)

### Datasets

<Warning>
  Dataset endpoints are deprecated for new workflows. Use [Tables](/reference/tables-create) and Table sheet imports instead.
</Warning>

* [List Datasets](/reference/list-datasets)
* [Get Dataset Rows](/reference/get-dataset-rows)
* [Create Dataset Group](/reference/create-dataset-group)
* [Create Dataset Version from File](/reference/create-dataset-version-from-file)
* [Create Dataset Version from Filter Params](/reference/create-dataset-version-from-filter-params)
* [Create Draft Dataset Version](/reference/create-draft-dataset-version)
* [Save Draft Dataset Version](/reference/save-draft-dataset-version)
* [Add Request Log to Dataset](/reference/add-request-log-to-dataset)
* [Add Trace to Dataset](/reference/add-trace-to-dataset)

### Evaluations

<Warning>
  Evaluation and Report endpoints are deprecated for new workflows. Use [Tables](/reference/tables-create), Table operations, and Table sheet scoring instead.
</Warning>

* [List Evaluations](/reference/list-evaluations)
* [Get Evaluation Rows](/reference/get-evaluation-rows)
* [Create Evaluation Pipeline](/reference/create-reports)
* [Run Report](/reference/run-report)
* [Get Report](/reference/get-report)
* [Get Report Score](/reference/get-report-score)
* [Add Report Columns](/reference/add-report-columns)
* [Edit Evaluation Pipeline Column](/reference/edit-report-column)
* [Delete Evaluation Pipeline Column](/reference/delete-report-column)
* [Update Report Score Card](/reference/update-report-score-card)
* [Rename Evaluation Pipeline](/reference/rename-report)
* [Delete Evaluation Pipeline](/reference/delete-report)
* [Delete Reports by Name](/reference/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.

For resolver strings, dependency objects, cell shapes, and score configuration, see [Tables Data Model](/features/tables/data-model).

* [Create Table](/reference/tables-create)
* [List Tables](/reference/tables-list)
* [Get Table](/reference/tables-get)
* [Update Table](/reference/tables-update)
* [Delete Table](/reference/tables-delete)
* [List Sheets](/reference/table-sheets-list)
* [Create Sheet](/reference/table-sheets-create)
* [Import File](/reference/table-sheet-imports-file-create)
* [Import Request Logs](/reference/table-sheet-imports-request-logs-create)
* [Get Sheet Import Operation](/reference/table-sheets-get-operation)
* [Get Sheet](/reference/table-sheets-get)
* [Update Sheet](/reference/table-sheets-update)
* [Delete Sheet](/reference/table-sheets-delete)
* [List Columns](/reference/table-sheet-columns-list)
* [Create Column](/reference/table-sheet-columns-create)
* [Update Column](/reference/table-sheet-columns-update)
* [Delete Column](/reference/table-sheet-columns-delete)
* [List Rows](/reference/table-sheet-rows-list)
* [Add Rows](/reference/table-sheet-rows-add)
* [Get Cell](/reference/table-sheet-cells-get)
* [Update Cell](/reference/table-sheet-cells-update)
* [Recalculate Cell](/reference/table-sheet-cells-recalculate)
* [Recalculate Cells](/reference/table-sheet-cells-recalculate-batch)
* [List Operations](/reference/table-sheet-operations-list)
* [Create Operation](/reference/table-sheet-operations-create)
* [Get Operation](/reference/table-sheet-operations-get)
* [Cancel Operation](/reference/table-sheet-operations-cancel)
* [Get Score](/reference/table-sheet-score-get)
* [Configure Score](/reference/table-sheet-score-configure)
* [Recalculate Score](/reference/table-sheet-score-recalculate)
* [List Versions](/reference/table-sheet-versions-list)
* [Create Version](/reference/table-sheet-versions-create)
* [Get Version](/reference/table-sheet-versions-get)
* [Get Score History](/reference/table-sheet-score-history-get)

<Tip>
  Pass `folder_id` on `Create Evaluation Pipeline`, [Create Table](/reference/tables-create), and the create endpoints under [Prompt Templates](#prompt-templates), [Datasets](#datasets), and [Workflows](#workflows) to organize new resources directly into a folder. Use [Resolve Folder ID by Path](/reference/resolve-folder-id) to look up an ID, or [Create Folder](/reference/create-folder) to make one. See [Unified Registry](#unified-registry).
</Tip>

### Workflows

* [List Workflows](/reference/list-workflows)
* [Get Workflow](/reference/get-workflow)
* [Get Workflow Labels](/reference/get-workflow-labels)
* [Create Workflow](/reference/create-workflow)
* [Update Workflow](/reference/patch-workflow)
* [Run Workflow](/reference/run-workflow)
* [Get Workflow Version Execution Results](/reference/workflow-version-execution-results)

### Skill Collections

* [List Skill Collections](/reference/list-skill-collections)
* [Create Skill Collection](/reference/create-skill-collection)
* [Get Skill Collection](/reference/get-skill-collection)
* [Update Skill Collection](/reference/update-skill-collection)
* [Save Skill Collection Version](/reference/save-skill-collection-version)

### Tool Registry

* [List Tool Registries](/reference/tool-registry-list)
* [Get Tool Registry](/reference/tool-registry-get)
* [Create Tool Registry](/reference/tool-registry-create)
* [Create Tool Version](/reference/tool-registry-create-version)
* [Test Execute Tool](/reference/tool-registry-test-execute)

### Environment Variables

* [List Workspace Env Vars](/reference/env-vars-workspace-list)
* [Create Workspace Env Var](/reference/env-vars-workspace-create)
* [Update Workspace Env Var](/reference/env-vars-workspace-update)
* [Delete Workspace Env Var](/reference/env-vars-workspace-delete)
* [List Tool Env Vars](/reference/env-vars-tool-list)
* [Create Tool Env Var](/reference/env-vars-tool-create)
* [Update Tool Env Var](/reference/env-vars-tool-update)
* [Delete Tool Env Var](/reference/env-vars-tool-delete)

### External IDs

Attach your own identifiers to PromptLayer resources so you can reference them by external ID. See the [External IDs overview](/reference/external-ids-overview) for details. Attach, list, and delete operations are available for:

* [Prompt Templates](/reference/external-ids-prompt-templates-list) (plus [upsert](/reference/external-ids-prompt-templates-upsert))
* [Workflows](/reference/external-ids-workflows-list)
* [Folders](/reference/external-ids-folders-list)
* [Reports](/reference/external-ids-reports-list)
* [Dataset Groups](/reference/external-ids-dataset-groups-list)
* [Skill Collections](/reference/external-ids-skill-collections-list)
* [Tool Registries](/reference/external-ids-tool-registry-list)

### Unified Registry

* [Create Folder](/reference/create-folder)
* [Update Folder](/reference/update-folder)
* [List Folder Entities](/reference/list-folder-entities)
* [Move Folder Entities](/reference/move-folder-entities)
* [Delete Folder Entities](/reference/delete-folder-entities)
* [Resolve Folder ID by Path](/reference/resolve-folder-id)