List LLM Configurations¶

GET /api/v1/llm_cfg/list

Overview¶

List LLM application configurations under the current workspace, supporting pagination, filtering, and statistical metric aggregation.

Query Request Parameters¶

Parameter Name	Type	Description
search	string	Fuzzy search by application name Allow empty: False
type	string	Application type, currently only supports `Langfuse` Allow empty: False Allowed values: ['Langfuse']
pageIndex	int	Page number Allow empty: False $default: 1
pageSize	int	Number of items per page (maximum 100) Allow empty: False $default: 20
timeRange	array	Time range for statistical information, an array of millisecond timestamps; defaults to the last 24 hours if not provided, e.g., `[1711900800000,1711987200000]` Allow empty: False

Parameter Additional Notes¶

Interface Description¶

Returns a list of LLM application configurations under the current workspace, supporting pagination, filtering, and statistical metric aggregation.

Differences from `quick_list`¶

This interface supports pagination.
This interface returns clientToken.
This interface returns ifTokenExpired.
This interface merges LLM call statistical information.

Statistical Information Fields¶

Field	Description
`statisticalInfo.callCount`	Number of calls
`statisticalInfo.errorCount`	Number of errors
`statisticalInfo.tokensCount`	Total tokens
`statisticalInfo.p50`	Request latency p50
`statisticalInfo.p75`	Request latency p75

Time Range Notes¶

The statistical query time range can be specified via timeRange, formatted as a millisecond timestamp array [start, end].
Defaults to the last 24 hours if not provided.
If the statistical service is temporarily unavailable, the interface will still return the configuration list, but statistical fields may be empty.

Filtering Rules¶

search performs fuzzy matching on jsonContent.name.
type performs exact filtering on jsonContent.type.

Request Example¶

curl 'https://openapi.truewatch.com/api/v1/llm_cfg/list?pageIndex=1&pageSize=20&type=Langfuse' \
  -H 'Content-Type: application/json' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --compressed

Response¶

{
    "code": 200,
    "content": {
        "data": [
            {
                "appId": "llm_app_demo",
                "jsonContent": {
                    "name": "Langfuse Prod",
                    "type": "Langfuse",
                    "site": "https://cloud.langfuse.com",
                    "extend": {
                        "service": "prod"
                    }
                },
                "uuid": "llm_app_demo",
                "workspaceUUID": "wksp_xxxx32",
                "clientToken": "token_xxx",
                "ifTokenExpired": false,
                "statisticalInfo": {
                    "callCount": 12,
                    "errorCount": 0,
                    "tokensCount": 456,
                    "p50": 10,
                    "p75": 15
                }
            }
        ],
        "pageInfo": {
            "count": 1,
            "pageIndex": 1,
            "pageSize": 20,
            "total": 1
        }
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-68EEEB4A-9ABC-4DDB-A72B-40F07F2699A5"
}