Skills List List

GET

https://api.respan.ai/agents/skills/list/

GET

/agents/skills/list/

$ curl https://api.respan.ai/agents/skills/list/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "count": 25,
3   "results": [
4     {
5       "id": "a3f1c9d2-4b7e-4f8a-9c3d-2e5b7f6a1d9e",
6       "name": "Customer Support Bot",
7       "description": "Skill set for handling customer inquiries and support tickets.",
8       "context_attachments": null,
9       "project": "Customer Service AI",
10       "created_by": {
11         "id": 42,
12         "email": "jane.doe@respan.ai",
13         "name": "Jane Doe",
14         "username": "jdoe",
15         "first_name": "Jane",
16         "last_name": "Doe"
17       },
18       "updated_by": {
19         "id": 42,
20         "email": "jane.doe@respan.ai",
21         "name": "Jane Doe",
22         "username": "jdoe",
23         "first_name": "Jane",
24         "last_name": "Doe"
25       },
26       "created_at": "2024-01-15T09:30:00Z",
27       "updated_at": "2024-04-10T14:45:00Z"
28     }
29   ],
30   "next": "https://api.respan.ai/agents/skills/list/?page=2&page_size=25",
31   "previous": null,
32   "total_count": 100,
33   "current_filters": {},
34   "filters_data": {}
35 }

GET/POST /agents/skills/list/ — List saved agent skills with filtering.

POST-for-filtering pattern: POST accepts filter payload, delegates to GET. Supports: pagination (page, page_size), sorting (sort_by), filtering.

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