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.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList available models
      • GETGet grouped models
      • GETList search-capable models
      • GETList configured search providers
      • GETList model configurations
      • POSTCreate model configuration
      • PUTUpdate model configuration
      • DELDelete model configuration
      • PATCHEnable or disable model configuration
      • PATCHSet default model configuration
      • GETGet model configuration usage
      • GETList distinct models in use
Dashboard
LogoLogo
Runtype APIModel Configs

List model configurations

GET
/v1/model-configs
GET
/v1/model-configs
$curl https://api.runtype.com/v1/model-configs \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "data": [
3    {
4      "id": "a3f1c9d2-4b7e-4f8a-9d3e-2b5f7c8a9e1d",
5      "userId": "user_7890abcd1234",
6      "organizationId": "org_4567efgh8901",
7      "provider": "openai",
8      "modelId": "gpt-4",
9      "providerKeyId": "key_1234abcd5678",
10      "isEnabled": true,
11      "isDefault": true,
12      "settings": {
13        "temperature": 0.7,
14        "maxTokens": 2048,
15        "topP": 0.9
16      },
17      "createdAt": "2024-05-20T15:45:00Z",
18      "updatedAt": "2024-06-10T12:00:00Z",
19      "displayName": "OpenAI GPT-4 Default",
20      "creator": "admin_user_001",
21      "creatorDisplayName": "Admin User",
22      "costPer1kTokens": 0.03,
23      "inputCostPer1kTokens": 0.015,
24      "outputCostPer1kTokens": 0.015,
25      "supportsCustomKey": true,
26      "keyStatus": "platform",
27      "maxOutputTokens": 4096,
28      "supportsStreaming": true,
29      "supportedResponseFormats": [
30        "json",
31        "text"
32      ],
33      "supportsSearch": true,
34      "reasoningCapability": {
35        "supported": true,
36        "provider": "openai",
37        "supportsReasoningSummary": true,
38        "googleThinkingMode": "budget"
39      },
40      "configScope": "user"
41    }
42  ],
43  "total": 1
44}

Get the authenticated user’s model configurations with enriched catalog metadata. Auto-provisions a default if none exist.

Was this page helpful?
Previous

Create model configuration

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Response

List of model configurations
datalist of objects
totalinteger

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error