prompts
List prompts
Retrieve prompts with pagination, sorting, and POST-based filters. Common filter fields include prompt_id, prompt_slug, name, description, starred, tags, current_version__updated_at, and is_deleted.
post/api/prompts/list/
Query parameters
pageinteger
Page number.
page_sizeinteger
Number of prompts per page. Maximum is 100.
sort_by'-id' | 'id' | '-current_version__updated_at' | 'current_version__updated_at'
Sort field. Prefix with - for descending. Common values are -id and -current_version__updated_at.
Headers
Authorizationstring required
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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.
Request body
Response
Paginated list of prompts.