LLM Configurations

List Configs

get

If no role_id is provided, return all LLM configs. If role_id is provided, return only the LLM configs that the role has permission to access.

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Query parameters

role_idany ofOptional

integerOptional

or

nullOptional

active_onlybooleanOptional

Responses

200

Successful Response

application/json

idintegerRequired

model_namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

statusany ofOptionalDefault: Inactive

stringOptional

or

nullOptional

is_defaultany ofOptionalDefault: false

booleanOptional

or

nullOptional

connected_atany ofOptional

string · date-timeOptional

or

nullOptional

last_syncany ofOptional

string · date-timeOptional

or

nullOptional

422

Validation Error

application/json

get

/api/v1/llm-configs

HTTPcURLJavaScriptPython

GET /api/v1/llm-configs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "model_name": "text",
    "description": "text",
    "status": "Inactive",
    "is_default": false,
    "connected_at": "2026-04-01T16:21:40.324Z",
    "last_sync": "2026-04-01T16:21:40.324Z"
  }
]

Create Config

post

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Body

application/json

model_namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

urlany ofOptional

stringOptional

or

nullOptional

usernameany ofOptional

stringOptional

or

nullOptional

passwordany ofOptional

stringOptional

or

nullOptional

api_keyany ofOptional

stringOptional

or

nullOptional

is_defaultany ofOptionalDefault: false

booleanOptional

or

nullOptional

statusany ofOptionalDefault: Inactive

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

idintegerRequired

model_namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

statusany ofOptionalDefault: Inactive

stringOptional

or

nullOptional

is_defaultany ofOptionalDefault: false

booleanOptional

or

nullOptional

connected_atany ofOptional

string · date-timeOptional

or

nullOptional

last_syncany ofOptional

string · date-timeOptional

or

nullOptional

422

Validation Error

application/json

post

/api/v1/llm-configs

HTTPcURLJavaScriptPython

POST /api/v1/llm-configs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "model_name": "text",
  "description": "text",
  "url": "text",
  "username": "text",
  "password": "text",
  "api_key": "text",
  "is_default": false,
  "status": "Inactive"
}

{
  "id": 1,
  "model_name": "text",
  "description": "text",
  "status": "Inactive",
  "is_default": false,
  "connected_at": "2026-04-01T16:21:40.324Z",
  "last_sync": "2026-04-01T16:21:40.324Z"
}

Read Config

get

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Path parameters

config_idintegerRequired

Responses

200

Successful Response

application/json

idintegerRequired

model_namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

statusany ofOptionalDefault: Inactive

stringOptional

or

nullOptional

is_defaultany ofOptionalDefault: false

booleanOptional

or

nullOptional

connected_atany ofOptional

string · date-timeOptional

or

nullOptional

last_syncany ofOptional

string · date-timeOptional

or

nullOptional

422

Validation Error

application/json

get

/api/v1/llm-configs/{config_id}

HTTPcURLJavaScriptPython

GET /api/v1/llm-configs/{config_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "model_name": "text",
  "description": "text",
  "status": "Inactive",
  "is_default": false,
  "connected_at": "2026-04-01T16:21:40.324Z",
  "last_sync": "2026-04-01T16:21:40.324Z"
}

Update Config

put

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Path parameters

config_idintegerRequired

Body

application/json

model_namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

urlany ofOptional

stringOptional

or

nullOptional

usernameany ofOptional

stringOptional

or

nullOptional

passwordany ofOptional

stringOptional

or

nullOptional

api_keyany ofOptional

stringOptional

or

nullOptional

is_defaultany ofOptionalDefault: false

booleanOptional

or

nullOptional

statusany ofOptionalDefault: Inactive

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

idintegerRequired

model_namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

statusany ofOptionalDefault: Inactive

stringOptional

or

nullOptional

is_defaultany ofOptionalDefault: false

booleanOptional

or

nullOptional

connected_atany ofOptional

string · date-timeOptional

or

nullOptional

last_syncany ofOptional

string · date-timeOptional

or

nullOptional

422

Validation Error

application/json

put

/api/v1/llm-configs/{config_id}

HTTPcURLJavaScriptPython

PUT /api/v1/llm-configs/{config_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "model_name": "text",
  "description": "text",
  "url": "text",
  "username": "text",
  "password": "text",
  "api_key": "text",
  "is_default": false,
  "status": "Inactive"
}

{
  "id": 1,
  "model_name": "text",
  "description": "text",
  "status": "Inactive",
  "is_default": false,
  "connected_at": "2026-04-01T16:21:40.324Z",
  "last_sync": "2026-04-01T16:21:40.324Z"
}

Delete Config

delete

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Path parameters

config_idintegerRequired

Responses

200

Successful Response

application/json

idintegerRequired

model_namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

statusany ofOptionalDefault: Inactive

stringOptional

or

nullOptional

is_defaultany ofOptionalDefault: false

booleanOptional

or

nullOptional

connected_atany ofOptional

string · date-timeOptional

or

nullOptional

last_syncany ofOptional

string · date-timeOptional

or

nullOptional

422

Validation Error

application/json

delete

/api/v1/llm-configs/{config_id}

HTTPcURLJavaScriptPython

DELETE /api/v1/llm-configs/{config_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "model_name": "text",
  "description": "text",
  "status": "Inactive",
  "is_default": false,
  "connected_at": "2026-04-01T16:21:40.324Z",
  "last_sync": "2026-04-01T16:21:40.324Z"
}