Skip to main content
GET
/
api
/
public
/
v2
/
requests
/
suggestions
Search Request Suggestions
curl --request GET \
  --url https://api.promptlayer.com/api/public/v2/requests/suggestions \
  --header 'X-API-KEY: <api-key>'
{
  "success": true,
  "values": [
    "production",
    "staging",
    "prod-v2"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.promptlayer.com/llms.txt

Use this file to discover all available pages before exploring further.

Get autocomplete suggestions for request log fields. Use this endpoint to power search UIs, discover values in your logs, or scope suggestions with the same filters used by request-log search.

​
Behavior Notes

  • This endpoint is rate limited to 10 requests per minute.
  • filter_group uses the same JSON-encoded structured filter syntax as Search Request Logs.
  • Fields that return nested values require metadata_key to identify the nested key.

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
field
enum<string>
required

Request log field to get suggestions for.

Available options:
engine,
provider_type,
prompt_id,
prompt,
tags,
metadata_keys,
status,
tool_names,
output_keys,
input_variable_keys,
metadata_values,
output_values,
input_variable_values
​
prefix
string

Case-insensitive prefix to filter suggestions.

​
metadata_key
string

Required when field is metadata_values, output_values, or input_variable_values. Specifies which key to get values for.

​
prompt_id
integer

Filter suggestions to a specific prompt template (only used when field is prompt).

Required range: x >= 1
​
filter_group
string

JSON-encoded filter group to scope suggestions to matching requests.

Response

Autocomplete suggestions.

​
success
enum<boolean>
required
Available options:
true
​
values
string[]
required

Suggested values for the requested field.