Get prompt summary
Returns the number of prompts matching the filters.
Authentication
Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.
Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.
Request
Each key is a field to filter on, and each value is a condition: {"<field>": {"operator": "<operator>", "value": [...]}}. A prompt must match every condition. To set two conditions on one field, such as a range, pass a list of conditions.
Operators: "" (equals, the default), not, in, not_in, lt, lte, gt, gte, contains, not_contains, icontains (ignores case), startswith, not_startswith, endswith, not_endswith, empty, not_empty. Put values in a list: "" and in match any of the listed values, and not and not_in match none of them. Other operators take one value; for empty and not_empty, send [""].
Fields: prompt_id, prompt_slug, name, description, starred, commit_count, version fields through current_version__<field> or live_version__<field> (for example current_version__model or current_version__updated_at), and is_deleted (send "value": true to count deleted prompts instead of active ones). Unsupported fields return a 400 error.
Example:
{
"starred": {"operator": "", "value": [true]},
"current_version__model": {"operator": "", "value": ["gpt-5.5"]}
}