> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PromptLayer

> PromptLayer is a prompt management and observability platform for versioning, evaluating, running, and analyzing LLM applications.

![PromptLayer logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/promptlayer.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=3c99c989d692274f49cd75c29cde1bc7)

* **Category:** artificial intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 16
* **Triggers:** 0
* **Slug:** `PROMPTLAYER`
* **Version:** 00000000\_00

## Tools

> [accordion] Get Prompt Template
>
> **Slug:** `PROMPTLAYER_GET_PROMPT_TEMPLATE`
>
> Retrieve a prompt template version, release label, messages, model metadata, snippets, and optionally provider-ready kwargs without executing it.
>
> #### Input Parameters
>
> **label** `string`
>
> Release label to resolve, such as production or staging. Cannot be used with version.
>
> **version** `integer`
>
> Specific positive version number. Cannot be used with label.
>
> **identifier** `string` *required*
>
> Prompt-template name or numeric ID.
>
> **resolve\_snippets** `boolean`
>
> Whether to expand snippet references in the returned template.
>
> **include\_llm\_kwargs** `boolean`
>
> Whether to include provider-specific kwargs derived from the template's model metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Registered Tool
>
> **Slug:** `PROMPTLAYER_GET_REGISTERED_TOOL`
>
> Retrieve a PromptLayer registered tool definition by ID or name at a selected version or release label without test execution.
>
> #### Input Parameters
>
> **label** `string`
>
> Release label to resolve; mutually exclusive with version.
>
> **version** `string`
>
> Specific version to resolve; mutually exclusive with label.
>
> **identifier** `string` *required*
>
> Registered tool's numeric ID or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Request Log
>
> **Slug:** `PROMPTLAYER_GET_REQUEST_LOG`
>
> Retrieve one PromptLayer request log with its recorded input, output, timing, usage, metadata, tags, and scores.
>
> #### Input Parameters
>
> **request\_id** `integer` *required*
>
> PromptLayer request-log ID returned by request-log search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Skill Collection
>
> **Slug:** `PROMPTLAYER_GET_SKILL_COLLECTION`
>
> Retrieve a PromptLayer skill collection and its files as JSON at a selected version or release label.
>
> #### Input Parameters
>
> **label** `string`
>
> Release label to resolve; mutually exclusive with version.
>
> **version** `integer`
>
> Positive version number to retrieve; mutually exclusive with label.
>
> **identifier** `string` *required*
>
> Skill collection UUID, name, or root path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Table
>
> **Slug:** `PROMPTLAYER_GET_TABLE`
>
> Retrieve one PromptLayer Table's metadata and per-sheet row counts by UUID.
>
> #### Input Parameters
>
> **table\_id** `string` *required*
>
> Table UUID returned by list tables.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow
>
> **Slug:** `PROMPTLAYER_GET_WORKFLOW`
>
> Retrieve a PromptLayer workflow definition by ID or name at a specific version or release label without running it.
>
> #### Input Parameters
>
> **label** `string`
>
> Release label to resolve; mutually exclusive with version.
>
> **version** `integer`
>
> Specific positive version to retrieve; mutually exclusive with label.
>
> **workflow\_id\_or\_name** `string` *required*
>
> Workflow ID or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Folder Entities
>
> **Slug:** `PROMPTLAYER_LIST_FOLDER_ENTITIES`
>
> Browse or search PromptLayer folders and registry entities in the API-key workspace, optionally recursively and with metadata.
>
> #### Input Parameters
>
> **tags** `array`
>
> Tags used to filter entity types that support tags. Accepts one or more tags.
>
> **flatten** `boolean`
>
> Return descendants recursively instead of direct children only.
>
> **sort\_by** `string ("created_at" | "updated_at" | "name" | "id")`
>
> Sort by created\_at, updated\_at, name, or id.
>
> **folder\_id** `integer`
>
> Folder to browse; omit for the workspace root.
>
> **sort\_order** `string ("asc" | "desc")`
>
> Sort direction: asc or desc.
>
> **external\_id** `string`
>
> External-ID value; provide together with external\_source.
>
> **filter\_types** `array`
>
> Entity types to include. Accepts one or more of FOLDER, PROMPT, SNIPPET, WORKFLOW, DATASET, REPORT, AB\_TEST, or INPUT\_VARIABLE\_SET.
>
> **search\_query** `string`
>
> Case-insensitive partial entity-name search.
>
> **external\_source** `string`
>
> External-ID source; provide together with external\_id.
>
> **created\_by\_email** `string`
>
> Creator email to match exactly.
>
> **include\_metadata** `boolean`
>
> Include type-specific metadata such as prompt type and latest version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Prompt Templates
>
> **Slug:** `PROMPTLAYER_LIST_PROMPT_TEMPLATES`
>
> Search and page through PromptLayer prompt templates and snippets without executing a model.
>
> #### Input Parameters
>
> **name** `string`
>
> Case-insensitive partial prompt-template name.
>
> **tags** `array`
>
> Tags that every returned template must contain. Accepts one tag or a list.
>
> **label** `string`
>
> Release label such as production or staging.
>
> **status** `string ("active" | "deleted" | "all")`
>
> Template status to return.
>
> **sort\_by** `string ("created_at" | "updated_at" | "name" | "id")`
>
> Field used to sort templates.
>
> **per\_page** `integer`
>
> Maximum templates in this page (1-100).
>
> **is\_snippet** `boolean`
>
> True for snippets only, false to exclude snippets, or omit for both.
>
> **sort\_order** `string ("asc" | "desc")`
>
> Sort direction.
>
> **external\_id** `string`
>
> External-ID value. Provide together with external\_source.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call.
>
> **created\_after** `string`
>
> Return templates created at or after this timestamp.
>
> **updated\_after** `string`
>
> Return templates updated at or after this timestamp.
>
> **created\_before** `string`
>
> Return templates created at or before this timestamp.
>
> **updated\_before** `string`
>
> Return templates updated at or before this timestamp.
>
> **external\_source** `string`
>
> External-ID source. Provide together with external\_id.
>
> **created\_by\_email** `string`
>
> Creator email to match exactly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Registered Tools
>
> **Slug:** `PROMPTLAYER_LIST_REGISTERED_TOOLS`
>
> List and filter tools defined in PromptLayer's tool registry without executing them.
>
> #### Input Parameters
>
> **sort\_by** `string ("created_at" | "updated_at" | "name" | "id")`
>
> Sort by created\_at, updated\_at, name, or id.
>
> **sort\_order** `string ("asc" | "desc")`
>
> Sort direction: asc or desc.
>
> **external\_id** `string`
>
> External-ID value; provide together with external\_source.
>
> **created\_after** `string`
>
> Return tools created at or after this timestamp.
>
> **updated\_after** `string`
>
> Return tools updated at or after this timestamp.
>
> **created\_before** `string`
>
> Return tools created at or before this timestamp.
>
> **updated\_before** `string`
>
> Return tools updated at or before this timestamp.
>
> **external\_source** `string`
>
> External-ID source; provide together with external\_id.
>
> **created\_by\_email** `string`
>
> Creator email to match exactly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Skill Collections
>
> **Slug:** `PROMPTLAYER_LIST_SKILL_COLLECTIONS`
>
> List and filter PromptLayer skill collections available in the API-key workspace.
>
> #### Input Parameters
>
> **sort\_by** `string ("created_at" | "updated_at" | "name" | "id")`
>
> Sort by created\_at, updated\_at, name, or id.
>
> **sort\_order** `string ("asc" | "desc")`
>
> Sort direction: asc or desc.
>
> **external\_id** `string`
>
> External-ID value; provide together with external\_source.
>
> **created\_after** `string`
>
> Return collections created at or after this timestamp.
>
> **updated\_after** `string`
>
> Return collections updated at or after this timestamp.
>
> **created\_before** `string`
>
> Return collections created at or before this timestamp.
>
> **updated\_before** `string`
>
> Return collections updated at or before this timestamp.
>
> **external\_source** `string`
>
> External-ID source; provide together with external\_id.
>
> **created\_by\_email** `string`
>
> Creator email to match exactly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Table Columns
>
> **Slug:** `PROMPTLAYER_LIST_TABLE_COLUMNS`
>
> List one page of user and optionally system columns for a PromptLayer Table sheet.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum columns in this page (1-100).
>
> **sheet\_id** `string` *required*
>
> Sheet UUID returned by list table sheets.
>
> **table\_id** `string` *required*
>
> Parent Table UUID.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> **include\_system\_columns** `boolean`
>
> Include system-managed price, latency, and prompt-output metadata columns.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Table Rows
>
> **Slug:** `PROMPTLAYER_LIST_TABLE_ROWS`
>
> Read one page of rows and cells from a PromptLayer Table sheet, with optional schema and execution aggregates.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum rows in this page (1-100).
>
> **order** `string ("asc" | "desc")`
>
> Row order.
>
> **sheet\_id** `string` *required*
>
> Sheet UUID returned by list table sheets.
>
> **table\_id** `string` *required*
>
> Parent Table UUID.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> **include\_columns** `boolean`
>
> Include column metadata alongside rows.
>
> **include\_row\_count** `boolean`
>
> Include the total row count.
>
> **include\_system\_columns** `boolean`
>
> Include system-managed price, latency, and prompt-output columns.
>
> **include\_execution\_metadata\_aggregates** `boolean`
>
> Include sheet and per-column price and latency aggregates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tables
>
> **Slug:** `PROMPTLAYER_LIST_TABLES`
>
> Search and page through PromptLayer Tables by folder, name, or referenced prompt.
>
> #### Input Parameters
>
> **name** `string`
>
> Case-insensitive partial Table title.
>
> **limit** `integer`
>
> Maximum Tables in this page (1-100).
>
> **order** `string ("asc" | "desc")`
>
> Sort direction.
>
> **folder\_id** `integer`
>
> Only Tables in this folder.
>
> **prompt\_id** `integer`
>
> Only Tables with a column referencing this prompt.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> **prompt\_label\_id** `integer`
>
> Only Tables referencing this prompt label.
>
> **prompt\_version\_id** `integer`
>
> Only Tables referencing this prompt version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Table Sheets
>
> **Slug:** `PROMPTLAYER_LIST_TABLE_SHEETS`
>
> List one page of sheets in a PromptLayer Table, optionally filtering by referenced prompt.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum sheets in this page (1-100).
>
> **order** `string ("asc" | "desc")`
>
> Sort direction.
>
> **table\_id** `string` *required*
>
> Parent Table UUID.
>
> **prompt\_id** `integer`
>
> Only sheets with a column referencing this prompt.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> **prompt\_label\_id** `integer`
>
> Only sheets referencing this prompt label.
>
> **prompt\_version\_id** `integer`
>
> Only sheets referencing this prompt version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflows
>
> **Slug:** `PROMPTLAYER_LIST_WORKFLOWS`
>
> Search and page through PromptLayer workflows without running them.
>
> #### Input Parameters
>
> **sort\_by** `string ("created_at" | "updated_at" | "name" | "id")`
>
> Sort by created\_at, updated\_at, name, or id.
>
> **per\_page** `integer`
>
> Maximum workflows in this page (1-100).
>
> **sort\_order** `string ("asc" | "desc")`
>
> Sort direction: asc or desc.
>
> **external\_id** `string`
>
> External-ID value; provide together with external\_source.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous response. Omit for the first page and pass it back unchanged to fetch the next page.
>
> **created\_after** `string`
>
> Return workflows created at or after this timestamp.
>
> **updated\_after** `string`
>
> Return workflows updated at or after this timestamp.
>
> **created\_before** `string`
>
> Return workflows created at or before this timestamp.
>
> **updated\_before** `string`
>
> Return workflows updated at or before this timestamp.
>
> **external\_source** `string`
>
> External-ID source; provide together with external\_id.
>
> **created\_by\_email** `string`
>
> Creator email to match exactly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Request Logs
>
> **Slug:** `PROMPTLAYER_SEARCH_REQUEST_LOGS`
>
> Search PromptLayer request logs by text or structured filters and return one rate-limited page sorted by operational fields.
>
> #### Input Parameters
>
> **query** `string`
>
> Free-text fuzzy-prefix search across prompt input and model output.
>
> **sort\_by** `string ("request_start_time" | "input_tokens" | "output_tokens" | "cost" | "latency_ms" | "status")`
>
> Operational field used to sort results.
>
> **per\_page** `integer`
>
> Maximum request logs to return on this page (1-25).
>
> **sort\_order** `string ("asc" | "desc")`
>
> Result sort direction.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call. Omit for the first page.
>
> **filter\_group** `object`
>
> Structured AND/OR filter group for request-log fields.
>
> **include\_prompt\_name** `boolean`
>
> Include the associated prompt-template name in each result.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
