List prompts | Respan Docs

List prompts with pagination and sorting.

pageintegerOptionalDefaults to 1

Page number

page_sizeintegerOptional<=100Defaults to 25

Number of items per page (max: 100)

sort_byenumOptional

Sort field (e.g., -current_version__updated_at, -id)

Allowed values:

Paginated list of prompts

countinteger

nextstring or null

previousstring or null

resultslist of objects

401

Unauthorized Error

404

Not Found Error

1	{
2	"count": 42,
3	"next": "https://api.respan.ai/api/prompts/list/?page=2",
4	"results": [
5	{
6	"id": "prompt_abc123",
7	"name": "Customer Support Assistant",
8	"description": "Handles customer support queries",
9	"current_version": {
10	"version": 3,
11	"model": "gpt-4",
12	"updated_at": "2026-01-20T10:30:00Z"
13	},
14	"live_version": {
15	"version": 2,
16	"model": "gpt-3.5-turbo",
17	"updated_at": "2026-01-15T08:00:00Z"
18	},
19	"tags": [],
20	"created_at": "2026-01-01T00:00:00Z"
21	}
22	]
23	}

1	curl https://api.respan.ai/api/prompts/list/ \
2	-H "Authorization: Bearer sk_live_xxxxx"