List models

GET /api/v1/cloud/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

Header	Required	Description
`Authorization`	Yes	`Bearer $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", "xhigh", "max"],
      "default_effort": "high",
      "max_input_tokens": 1000000,
      "default_context_window": 200000,
      "available_context_windows": [200000, 400000, 1000000]
    }
  ],
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	Available Model objects
`has_more`	boolean	Always `false`; model listing is not paginated

Each model object contains:

Field	Type	Description
`id`	string	Model identifier to pass as the Agent `model`
`type`	string	Always `"model"`
`display_name`	string	Human-readable model name
`source`	string	Model source, usually `system`; `user` for account-specific models
`is_enabled`	boolean	Whether the model is enabled and usable
`is_new`	boolean	Whether the model is marked as new
`price_factor`	number	Optional relative price multiplier
`efforts`	array	Optional supported reasoning effort levels, such as `none`, `low`, `medium`, `high`, `xhigh`, or `max`
`default_effort`	string	Optional default effort level when the upstream catalog designates one
`max_input_tokens`	integer	Maximum input context supported by the model, in tokens
`default_context_window`	integer	Optional default context window (in tokens) to use when the Agent does not set one
`available_context_windows`	array of integer	Optional user-selectable context window tiers (in tokens) accepted as `model.context_window` when creating or updating an Agent

Notes

Only enabled models are returned.
The response does not include internal routing, provider, 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

HTTP	Type	Trigger
401	`authentication_error`	PAT invalid or expired
503	`api_error`	Model catalog is temporarily unavailable

See Errors for the full error envelope.

Agent setup

Create a reusable, versioned agent configuration.

First steps

Define your agent

Configure agent environment

Delegate work to your agent

Manage agent context

Best Practices

API reference

Headers

Query parameters

Example request

Example response

Response fields

Notes

Errors

Agent setup

​Headers

​Query parameters

​Example request

​Example response

​Response fields

​Notes

​Errors

​Related

Agent setup

Headers

Query parameters

Example request

Example response

Response fields

Notes

Errors

Related