Jwt Prompt Versions List

GET

https://api.respan.ai/prompts/jwt/prompt-versions/

GET

/prompts/jwt/prompt-versions/

$ curl https://api.respan.ai/prompts/jwt/prompt-versions/ \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "count": 25,
3   "results": [
4     {
5       "id": 1,
6       "edited_by": {
7         "id": 1,
8         "email": "string",
9         "name": "string",
10         "username": "string",
11         "first_name": "string",
12         "last_name": "string"
13       },
14       "updated_at": "2024-01-15T09:30:00Z",
15       "prompt": 1,
16       "parent_prompt": "string",
17       "messages": [
18         {
19           "role": "string",
20           "content": "string",
21           "id": "string",
22           "model": "string",
23           "tool_calls": [
24             {}
25           ],
26           "tool_call_id": "string"
27         }
28       ],
29       "variables": {},
30       "tools": [
31         {
32           "type": "function",
33           "function": {
34             "name": "string",
35             "description": "string",
36             "strict": true,
37             "additionalProperties": true,
38             "parameters": {
39               "type": "object",
40               "properties": {},
41               "required": [
42                 "string"
43               ]
44             }
45           }
46         }
47       ],
48       "load_balance_models": [
49         {
50           "model": "string",
51           "weight": 1.1,
52           "credentials": {}
53         }
54       ],
55       "thinking": {
56         "type": "enabled",
57         "budget_tokens": 1
58       },
59       "tool_choice": "string",
60       "response_format": {},
61       "json_schema": {},
62       "is_deployed": true,
63       "prompt_version_id": "string",
64       "description": "string",
65       "created_at": "2024-01-15T09:30:00Z",
66       "version": 1,
67       "model": "string",
68       "stream": true,
69       "temperature": 1.1,
70       "max_tokens": 1,
71       "top_p": 1.1,
72       "frequency_penalty": 1.1,
73       "presence_penalty": 1.1,
74       "reasoning_effort": "string",
75       "verbosity": "string",
76       "seed": 1,
77       "readonly": true,
78       "fallback_models": [
79         "string"
80       ],
81       "is_enforcing_response_format": true
82     }
83   ],
84   "next": "string",
85   "previous": "string",
86   "total_count": 100,
87   "current_filters": {},
88   "filters_data": {}
89 }

Unified view for prompt versions list/create operations. Supports both JWT (dashboard) and API key (public API) authentication.

Uses NestedResourceMixin for parent-aware access control:

READ child = READ parent → superadmin can view any
WRITE child = WRITE parent → requires org match (for JWT auth)

JWT auth: uses prompt pk from URL kwargs, exact matching API key auth: uses prompt_id from URL kwargs, startswith matching

Unified view for prompt versions list/create operations. Supports both JWT (dashboard) and API key (public API) authentication. Uses NestedResourceMixin for parent-aware access control: - READ child = READ parent → superadmin can view any - WRITE child = WRITE parent → requires org match (for JWT auth) JWT auth: uses prompt pk from URL kwargs, exact matching API key auth: uses prompt_id from URL kwargs, startswith matching

Authentication

AuthorizationBearer

JWT access token or Respan API key

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Response

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

total_countinteger

current_filtersobject

Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters.

Each key is a metric name (str), and each value can be:

A single MetricFilterParamPydantic (one condition)
A List[MetricFilterParamPydantic] (multiple conditions for same metric)
A FilterBundlePydantic (nested filter bundle with connector)

Note: Uses extra=“allow” for dynamic metric name fields. The pydantic_extra annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.

filters_dataobject