For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • POSTList prompts
      • POSTCreate a prompt
      • GETRetrieve a prompt
      • PATCHUpdate a prompt
      • DELDelete a prompt
      • POSTCreate a prompt version
      • GETList prompt versions
      • GETRetrieve a prompt version
      • PATCHUpdate a prompt version
      • DELDelete a prompt version
      • POSTCommit a prompt version
      • POSTDeploy a prompt version
      • GETGet prompts summary
      • POSTGet prompts summary with filters
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferencePrompts

List prompts

POST
https://api.respan.ai/api/prompts/list/
POST
/api/prompts/list/
$curl -X POST "https://api.respan.ai/api/prompts/list/?page=1&page_size=25&sort_by=-current_version__updated_at" \
>     -H "Authorization: Bearer sk_live_xxxxx" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "filters": {
>    "name": {
>      "value": [
>        "support"
>      ],
>      "operator": "icontains"
>    },
>    "starred": {
>      "value": [
>        true
>      ],
>      "operator": ""
>    }
>  },
>  "operator": "AND"
>}'
1{
2  "count": 42,
3  "next": "https://api.respan.ai/api/prompts/list/?page=2",
4  "previous": null,
5  "results": [
6    {
7      "id": "prompt_abc123",
8      "name": "Customer Support Assistant",
9      "description": "Handles customer support queries with empathy",
10      "prompt_slug": "customer-support-assistant",
11      "tags": [
12        {
13          "id": "tag_abc123",
14          "name": "support",
15          "color": "#3B82F6",
16          "created_at": "2026-01-01T00:00:00Z",
17          "updated_at": "2026-01-01T00:00:00Z"
18        }
19      ],
20      "current_version": {
21        "version": 3,
22        "model": "gpt-4o",
23        "updated_at": "2026-01-20T10:30:00Z"
24      },
25      "live_version": {
26        "version": 2,
27        "model": "gpt-4o-mini",
28        "updated_at": "2026-01-15T08:00:00Z"
29      },
30      "created_at": "2026-01-01T00:00:00Z",
31      "updated_at": "2026-01-20T10:30:00Z"
32    }
33  ]
34}

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.

Was this page helpful?
Previous

Create a prompt

Next
Built with

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Query parameters

pageintegerOptionalDefaults to 1
Page number.
page_sizeintegerOptional<=100Defaults to 25
Number of prompts per page. Maximum is 100.
sort_byenumOptionalDefaults to -id

Sort field. Prefix with - for descending. Common values are -id and -current_version__updated_at.

Allowed values:

Request

This endpoint expects an object.
filtersobjectOptional

Prompt filters. See Filters API Reference for operator syntax.

operatorenumOptionalDefaults to AND
Logical operator for combining filters.
Allowed values:

Response

Paginated list of prompts.
countinteger
Total number of matching prompts.
nextstring or null
Next page URL.
previousstring or null
Previous page URL.
resultslist of objects

Errors

401
Unauthorized Error