List response-format presets

GET

https://api.respan.ai/api/response-format-presets/

List the project’s saved response-format schemas. List rows intentionally omit the schema content; retrieve a preset to load it into an editor.

Authentication

AuthorizationBearer

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.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Query parameters

pageintegerOptional>=1

page_sizeintegerOptional>=1

sort_bystringOptionalDefaults to -updated_at

Response

Paginated response-format presets.

countinteger

resultslist of objects

nextstring or nullOptional

previousstring or nullOptional

total_countintegerOptional

current_filtersmap from strings to anyOptional

Errors

401

Unauthorized Error

1	{
2	"count": 1,
3	"results": [
4	{
5	"id": "string",
6	"name": "string",
7	"created_at": "2024-01-15T09:30:00Z",
8	"updated_at": "2024-01-15T09:30:00Z",
9	"created_by": {
10	"id": 1,
11	"email": "string",
12	"name": "string",
13	"username": "string",
14	"first_name": "string",
15	"last_name": "string"
16	}
17	}
18	],
19	"next": "string",
20	"previous": "string",
21	"total_count": 1,
22	"current_filters": {}
23	}

$	curl https://api.respan.ai/api/response-format-presets/ \
>	-H "Authorization: Bearer <respanApiKey>"