Query Prompts

Search and filter prompts with pagination

1 min read

posthttps://api.helicone.ai/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"  }]

posthttps://api.helicone.ai/v1/prompt-2025/query

Retrieves a paginated list of prompts based on search criteria and tag filters.

Request Body#

searchstringrequired#

Search term to filter prompts by name

tagsFilterstring[]required#

Array of tags to filter prompts (shows prompts with any of these tags)

pagenumberrequired#

Page number for pagination (0-based)

pageSizenumberrequired#

Number of prompts to return per page

Response#

Returns an array of prompt objects matching the search criteria.

idstring#

Unique identifier of the prompt

namestring#

Name of the prompt

tagsstring[]#

Array of tags associated with the prompt

created_atstring#

ISO timestamp when the prompt was created

Delete Prompt Version Get Prompt Version