List prompts | Respan Docs

Lists prompts with advanced filtering and pagination.

Query Parameters:

page (integer, optional): Page number (default: 1)
page_size (integer, optional): Number of items per page (default: 25, max: 100)
sort_by (string, optional): Sort field (e.g., -current_version__updated_at, -id)

Python

1 import requests
2 
3 url = "https://api.respan.ai/api/prompts/list/"
4 api_key = "YOUR_RESPAN_API_KEY"
5 headers = {
6     "Authorization": f"Bearer {api_key}",
7     "Content-Type": "application/json"
8 }
9 params = {
10     "page": 1,
11     "page_size": 25
12 }
13 
14 response = requests.get(url, headers=headers, params=params)
15 print(response.json())

TypeScript

1 fetch('https://api.respan.ai/api/prompts/list/?page=1&page_size=25', {
2   method: 'GET',
3   headers: {
4     'Content-Type': 'application/json',
5     'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6   }
7 })
8 .then(response => response.json())
9 .then(data => console.log(data));

Lists prompts with advanced filtering and pagination. **Query Parameters:** - `page` (integer, optional): Page number (default: 1) - `page_size` (integer, optional): Number of items per page (default: 25, max: 100) - `sort_by` (string, optional): Sort field (e.g., `-current_version__updated_at`, `-id`) ```Python Python import requests url = "https://api.respan.ai/api/prompts/list/" api_key = "YOUR_RESPAN_API_KEY" headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } params = { "page": 1, "page_size": 25 } response = requests.get(url, headers=headers, params=params) print(response.json()) ``` ```TypeScript TypeScript fetch('https://api.respan.ai/api/prompts/list/?page=1&page_size=25', { method: 'GET', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_RESPAN_API_KEY' } }) .then(response => response.json()) .then(data => console.log(data)); ```

Authentication

AuthorizationBearer

API key authentication. Get your API key from https://platform.respan.ai/platform/api-keys

Query parameters

pageintegerOptionalDefaults to 1

Page number

page_sizeintegerOptional<=100Defaults to 25

Number of items per page (max: 100)

sort_bystringOptional

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

Response

Paginated list of prompts

countinteger

nextstring or null

previousstring or null

resultslist of objects

Errors

401

Unauthorized Error

Lists prompts with advanced filtering and pagination.

Query Parameters:

page (integer, optional): Page number (default: 1)
page_size (integer, optional): Number of items per page (default: 25, max: 100)
sort_by (string, optional): Sort field (e.g., -current_version__updated_at, -id)

Python

1 import requests
2 
3 url = "https://api.respan.ai/api/prompts/list/"
4 api_key = "YOUR_RESPAN_API_KEY"
5 headers = {
6     "Authorization": f"Bearer {api_key}",
7     "Content-Type": "application/json"
8 }
9 params = {
10     "page": 1,
11     "page_size": 25
12 }
13 
14 response = requests.get(url, headers=headers, params=params)
15 print(response.json())

TypeScript

1 fetch('https://api.respan.ai/api/prompts/list/?page=1&page_size=25', {
2   method: 'GET',
3   headers: {
4     'Content-Type': 'application/json',
5     'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6   }
7 })
8 .then(response => response.json())
9 .then(data => console.log(data));

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	import requests
2
3	url = "https://api.respan.ai/api/prompts/list/"
4	api_key = "YOUR_RESPAN_API_KEY"
5	headers = {
6	"Authorization": f"Bearer {api_key}",
7	"Content-Type": "application/json"
8	}
9	params = {
10	"page": 1,
11	"page_size": 25
12	}
13
14	response = requests.get(url, headers=headers, params=params)
15	print(response.json())

1	fetch('https://api.respan.ai/api/prompts/list/?page=1&page_size=25', {
2	method: 'GET',
3	headers: {
4	'Content-Type': 'application/json',
5	'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6	}
7	})
8	.then(response => response.json())
9	.then(data => console.log(data));

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