Skip to main content
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
  }'

{
  "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
}
Query prompts with search, filtering, and pagination options.

​
Request Body

​
search
string
required
Search term to filter prompts by name
​
tagsFilter
string[]
required
Array of tags to filter by. Empty array returns all prompts.
​
page
number
required
Page number for pagination (0-indexed)
​
pageSize
number
required
Number of results per page

​
Response

​
data
array
Array of prompt objects
​
error
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
  }'

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

​
Pagination

Use the page and pageSize parameters to paginate through results:
  • Page 1: page: 0
  • Page 2: page: 1
  • Page 3: page: 2
Recommended pageSize values: 10, 25, 50, or 100

​
Filtering

​
Search by Name

The search parameter filters prompts by name (case-insensitive, partial match).

​
Filter by Tags

The tagsFilter 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