List models

GET /api/v1/forward/models This endpoint returns the enabled models available to the current account. When creating or updating a Template, or overriding the model in an Identity Config, use the returned id, efforts, and context-window information.

Headers

Header	Required	Description
Authorization	Yes	`Bearer <PAT or admin SAT>`. An Identity-level SAT cannot call this endpoint.

Query parameters

This endpoint has no query parameters and does not support pagination.

Example request

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

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "ultimate",
      "display_name": "Ultimate",
      "is_enabled": true,
      "is_new": false,
      "is_vl": true,
      "support_disable_reasoning": true,
      "price_factor": 1.6,
      "efforts": ["low", "medium", "high", "xhigh", "max"],
      "default_effort": "high",
      "speed": ["standard", "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	Model objects available to the current account.
`has_more`	boolean	Always `false`; model listing is not paginated.

Each Model object in data contains:

Field	Type	Description
`id`	string	Model identifier that can be used in the Template or Identity Config `model` field.
`display_name`	string	Human-readable model name.
`is_enabled`	boolean	Whether the model is enabled. This endpoint returns only enabled models.
`is_new`	boolean	Whether the model is marked as new.
`is_vl`	boolean	Whether the model supports vision or image input.
`support_disable_reasoning`	boolean	Whether reasoning can be disabled.
`price_factor`	number	Optional relative price multiplier.
`efforts`	string[]	Optional supported reasoning effort levels.
`default_effort`	string	Optional default reasoning effort level.
`speed`	string[]	Optional supported inference speeds, such as `standard` and `high`. If omitted, only standard speed is supported.
`max_input_tokens`	integer	Optional maximum input context supported by the model, in tokens.
`default_context_window`	integer	Optional default context window in tokens when `model.context_window` is not specified.
`available_context_windows`	integer[]	Optional context-window tiers in tokens that can be selected for `model.context_window`.

Errors

HTTP	Type	Code	Trigger
401	`authentication_error`	-	The PAT or admin SAT is invalid or expired, or a Service Account Key is used directly.
403	`permission_error`	-	An Identity-level SAT is used to call this management endpoint.
503	`api_error`	-	The model catalog is temporarily unavailable.

Notes

Use only model IDs returned by the current response. Different accounts may see different models.
speed currently describes model capabilities only. Forward Template and Identity Config model objects accept only id, effort, and context_window.
GET /api/v2/forward/models is unavailable. Use the v1 path.
The response omits non-public fields such as internal routing, default models, and promotional configuration.

Headers

Query parameters

Example request

Example response

Response fields

Errors

Notes

Create template

Create or update identity config

​Headers

​Query parameters

​Example request

​Example response

​Response fields

​Errors

​Notes

​Related

Create template

Create or update identity config

Headers

Query parameters

Example request

Example response

Response fields

Errors

Notes

Related