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, 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.

Request body

Response

Paginated list of prompts.

countinteger

Total number of matching prompts.

nextstring nullable

Next page URL.

previousstring nullable

Previous page URL.

Changes

No recorded changes to this endpoint across all 1 revision of this API.