Skip to main content
GET /v1/models Lists the enabled models available to the current account. Use this endpoint to choose the model value when creating or updating an Agent.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

​
Query parameters

This endpoint does not currently accept query parameters.

​
Example request

curl -X GET "https://api.qoder.com/api/v1/cloud/models" \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "data": [
    {
      "id": "ultimate",
      "type": "model",
      "display_name": "Ultimate",
      "source": "system",
      "is_enabled": true,
      "is_new": false,
      "price_factor": 1.6,
      "efforts": ["low", "medium", "high"],
      "default_effort": "medium"
    }
  ],
  "has_more": false
}

​
Response fields

FieldTypeDescription
dataarrayAvailable Model objects
has_morebooleanAlways false; model listing is not paginated
Each model object contains:
FieldTypeDescription
idstringModel identifier to pass as the Agent model
typestringAlways "model"
display_namestringHuman-readable model name
sourcestringModel source, usually system; user for account-specific models
is_enabledbooleanWhether the model is enabled and usable
is_newbooleanWhether the model is marked as new
price_factornumberOptional relative price multiplier
effortsarrayOptional supported reasoning effort levels, such as none, low, medium, high, xhigh, or max
default_effortstringOptional default effort level when the upstream catalog designates one

​
Notes

  • Only enabled models are returned.
  • The response does not include internal routing, provider, token limit, secret, or description fields.
  • The model catalog is resolved for the authenticated user and the service’s configured scene. The default scene is assistant.

​
Errors

HTTPTypeTrigger
401authentication_errorPAT invalid or expired
503api_errorModel catalog is temporarily unavailable
See Errors for the full error envelope.

Agent setup

Create a reusable, versioned agent configuration.