curl -X POST https://api.helicone.ai/v1/prompt-2025/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "customer",
"tagsFilter": ["support"],
"page": 0,
"pageSize": 10
}'
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/query', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
search: 'customer',
tagsFilter: ['support'],
page: 0,
pageSize: 10,
}),
});
const result = await response.json();
import requests
response = requests.post(
'https://api.helicone.ai/v1/prompt-2025/query',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'search': 'customer',
'tagsFilter': ['support'],
'page': 0,
'pageSize': 10,
},
)
result = response.json()
{
"data": [
{
"id": "prompt_abc123xyz",
"name": "Customer Support Agent",
"tags": ["support", "customer-service"],
"created_at": "2024-03-10T12:00:00Z"
},
{
"id": "prompt_def456uvw",
"name": "Customer Feedback Analyzer",
"tags": ["support", "analytics"],
"created_at": "2024-03-09T10:30:00Z"
}
],
"error": null
}
{
"data": null,
"error": "Failed to query prompts"
}
Prompts
Query Prompts
Search and filter prompts
POST
/
v1
/
prompt-2025
/
query
curl -X POST https://api.helicone.ai/v1/prompt-2025/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "customer",
"tagsFilter": ["support"],
"page": 0,
"pageSize": 10
}'
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/query', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
search: 'customer',
tagsFilter: ['support'],
page: 0,
pageSize: 10,
}),
});
const result = await response.json();
import requests
response = requests.post(
'https://api.helicone.ai/v1/prompt-2025/query',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'search': 'customer',
'tagsFilter': ['support'],
'page': 0,
'pageSize': 10,
},
)
result = response.json()
{
"data": [
{
"id": "prompt_abc123xyz",
"name": "Customer Support Agent",
"tags": ["support", "customer-service"],
"created_at": "2024-03-10T12:00:00Z"
},
{
"id": "prompt_def456uvw",
"name": "Customer Feedback Analyzer",
"tags": ["support", "analytics"],
"created_at": "2024-03-09T10:30:00Z"
}
],
"error": null
}
{
"data": null,
"error": "Failed to query prompts"
}
Query prompts with search, filtering, and pagination options.
Request Body
string
required
Search term to filter prompts by name
string[]
required
Array of tags to filter by. Empty array returns all prompts.
number
required
Page number for pagination (0-indexed)
number
required
Number of results per page
Response
array
string | null
Error message if the request failed, null otherwise
curl -X POST https://api.helicone.ai/v1/prompt-2025/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "customer",
"tagsFilter": ["support"],
"page": 0,
"pageSize": 10
}'
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/query', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
search: 'customer',
tagsFilter: ['support'],
page: 0,
pageSize: 10,
}),
});
const result = await response.json();
import requests
response = requests.post(
'https://api.helicone.ai/v1/prompt-2025/query',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'search': 'customer',
'tagsFilter': ['support'],
'page': 0,
'pageSize': 10,
},
)
result = response.json()
{
"data": [
{
"id": "prompt_abc123xyz",
"name": "Customer Support Agent",
"tags": ["support", "customer-service"],
"created_at": "2024-03-10T12:00:00Z"
},
{
"id": "prompt_def456uvw",
"name": "Customer Feedback Analyzer",
"tags": ["support", "analytics"],
"created_at": "2024-03-09T10:30:00Z"
}
],
"error": null
}
{
"data": null,
"error": "Failed to query prompts"
}
Pagination
Use thepage and pageSize parameters to paginate through results:
- Page 1:
page: 0 - Page 2:
page: 1 - Page 3:
page: 2
pageSize values: 10, 25, 50, or 100
Filtering
Search by Name
Thesearch parameter filters prompts by name (case-insensitive, partial match).
Filter by Tags
ThetagsFilter parameter accepts an array of tags:
- Empty array
[]returns all prompts - Single tag
["support"]returns prompts with that tag - Multiple tags
["support", "customer-service"]returns prompts with any of those tags
⌘I