Skip to main content
GET
Get LLM models
What it does: Retrieve all available LLM (Large Language Model) providers and their supported models. The LLM is the reasoning engine of your agent — it processes user input, maintains conversation context, and generates responses based on the system prompt. Use this endpoint to populate model selection options when configuring an agent’s llmParams.

Required Permission

agents

Query Parameters

Minimum working example

Additional examples

Filter by Provider

Response

Success (200)

Response Fields

Errors

401 Unauthorized - Invalid or missing API key
An unknown provider filter value returns HTTP 200 with an empty LLM array — not an error. See Error Reference for other status codes.

Use Cases

  • Populating an LLM provider and model selector during agent creation or configuration
  • Allowing users to switch between language models (e.g. from a smaller model to a larger one)
  • Filtering models by provider when your organization has a specific LLM contract
The provider.providerId and modelId values returned here map directly to the provider and model fields in the Update Agent llmParams object. Use them as-is.
Use the provider filter to show only the models available from your preferred LLM vendor, simplifying the selection UI for your users.
Save the requestId from every response. You will need it if you contact Gnani support to trace a specific request.

Authorizations

x-api-key
string
header
required

API key with 'agents' permission

Query Parameters

provider
string

Filter results to a specific LLM provider

Example:

"gnani"

Response

Models retrieved successfully

status
string
Example:

"success"

requestId
string
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

message
string
response
object