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
  }'

[
  {
    "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

​
search
string
required
Search term to filter prompts by name
​
tagsFilter
string[]
required
Array of tags to filter prompts (shows prompts with any of these tags)
​
page
number
required
Page number for pagination (0-based)
​
pageSize
number
required
Number of prompts to return per page

​
Response

Returns an array of prompt objects matching the search criteria.
​
id
string
Unique identifier of the prompt
​
name
string
Name of the prompt
​
tags
string[]
Array of tags associated with the prompt
​
created_at
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
  }'

[
  {
    "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"
  }
]