> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Model data structures

> Shared model catalog response structures.

## Model object

Returned by `GET /api/v1/cloud/models`.

| Field                       | Type             | Description                                                                                               |
| --------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------- |
| `id`                        | string           | Model identifier to pass as `agent.model`                                                                 |
| `type`                      | string           | Always `"model"`                                                                                          |
| `display_name`              | string           | Display name for UI and selection                                                                         |
| `source`                    | string           | Model source. Valid values: `system`, `user`                                                              |
| `is_enabled`                | boolean          | Whether the model is enabled. The list endpoint filters out disabled upstream models                      |
| `is_new`                    | boolean          | Whether the model is marked as new                                                                        |
| `price_factor`              | number           | Optional relative price factor                                                                            |
| `efforts`                   | array of string  | Optional supported reasoning effort values. Valid values: `none`, `low`, `medium`, `high`, `xhigh`, `max` |
| `default_effort`            | string           | Optional default effort value when provided by the upstream catalog                                       |
| `max_input_tokens`          | integer          | Maximum input context supported by the model, in tokens                                                   |
| `default_context_window`    | integer          | Optional default context window (in tokens) applied when the Agent does not set `model.context_window`    |
| `available_context_windows` | array of integer | Optional user-selectable context window tiers (in tokens) accepted as `model.context_window` on an Agent  |

## Model list response

| Field      | Type                                   | Description                               |
| ---------- | -------------------------------------- | ----------------------------------------- |
| `data`     | array of [Model object](#model-object) | Available models for the configured scene |
| `has_more` | boolean                                | Always `false`                            |

## Related

<CardGroup cols={2}>
  <Card title="Agent setup" icon="user-gear" href="/cloud-agents/define-agent">
    Create a reusable, versioned agent configuration.
  </Card>
</CardGroup>