Query Prompts

Search and filter prompts

POST /v1/prompt-2025/query

cURL

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

200 Success

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

Show Prompt Object

id · string

The unique identifier for the prompt

name · string

Name of the prompt template

tags · string[]

Array of tags associated with the prompt

created_at · string

ISO 8601 timestamp of when the prompt was created

error · string | null

Error message if the request failed, null otherwise

cURL

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

200 Success

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