curl -X POST "https://api.helicone.ai/v1/prompt-2025/query" \
-H "Authorization: Bearer $HELICONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "support",
"tagsFilter": ["chatbot", "customer"],
"page": 0,
"pageSize": 10
}'
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/query', {
method: 'POST',
headers: {
'Authorization': `Bearer ${HELICONE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
search: "support",
tagsFilter: ["chatbot", "customer"],
page: 0,
pageSize: 10
}),
});
const prompts = await response.json();
[
{
"id": "prompt_123",
"name": "Customer Support Bot",
"tags": ["support", "chatbot"],
"created_at": "2024-01-15T10:30:00Z"
},
{
"id": "prompt_456",
"name": "Support Ticket Classifier",
"tags": ["support", "classification"],
"created_at": "2024-01-14T09:15:00Z"
}
]
Prompts
Query Prompts
Search and filter prompts with pagination
POST
/
v1
/
prompt-2025
/
query
curl -X POST "https://api.helicone.ai/v1/prompt-2025/query" \
-H "Authorization: Bearer $HELICONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "support",
"tagsFilter": ["chatbot", "customer"],
"page": 0,
"pageSize": 10
}'
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/query', {
method: 'POST',
headers: {
'Authorization': `Bearer ${HELICONE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
search: "support",
tagsFilter: ["chatbot", "customer"],
page: 0,
pageSize: 10
}),
});
const prompts = await response.json();
[
{
"id": "prompt_123",
"name": "Customer Support Bot",
"tags": ["support", "chatbot"],
"created_at": "2024-01-15T10:30:00Z"
},
{
"id": "prompt_456",
"name": "Support Ticket Classifier",
"tags": ["support", "classification"],
"created_at": "2024-01-14T09:15:00Z"
}
]
Retrieves a paginated list of prompts based on search criteria and tag filters.
Request Body
string
required
Search term to filter prompts by name
string[]
required
Array of tags to filter prompts (shows prompts with any of these tags)
number
required
Page number for pagination (0-based)
number
required
Number of prompts to return per page
Response
Returns an array of prompt objects matching the search criteria.string
Unique identifier of the prompt
string
Name of the prompt
string[]
Array of tags associated with the prompt
string
ISO timestamp when the prompt was created
curl -X POST "https://api.helicone.ai/v1/prompt-2025/query" \
-H "Authorization: Bearer $HELICONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "support",
"tagsFilter": ["chatbot", "customer"],
"page": 0,
"pageSize": 10
}'
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/query', {
method: 'POST',
headers: {
'Authorization': `Bearer ${HELICONE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
search: "support",
tagsFilter: ["chatbot", "customer"],
page: 0,
pageSize: 10
}),
});
const prompts = await response.json();
[
{
"id": "prompt_123",
"name": "Customer Support Bot",
"tags": ["support", "chatbot"],
"created_at": "2024-01-15T10:30:00Z"
},
{
"id": "prompt_456",
"name": "Support Ticket Classifier",
"tags": ["support", "classification"],
"created_at": "2024-01-14T09:15:00Z"
}
]
Was this page helpful?