# List models for a specific provider

Source: <https://everruns.com/docs/api/operations/list_provider_models/>

GET

/v1/providers/{provider\_id}/models

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/providers/example/models';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/providers/example/models
```

* Production APIapp.everruns.com/api/v1/providers/{provider\_id}/models

## Parameters

### Path Parameters

**provider\_id**

required

string

Provider ID (prefixed, e.g., prov\_…)

## Responses

### 200

List of models

Media typeapplication/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a `data` field.

object

**data**

required

Array of items returned by the list operation.

Array

Wrapper that adds API and UI links to a serialized resource.

Uses `self_url` (not `url`) for the API link to avoid collision with resources that already have a `url` field (e.g. McpServer). The `allowed_actions` array carries state-aware hypermedia links — empty (and omitted from the wire shape) until the underlying resource opts into the convention by overriding `ResourceUrlable::allowed_actions`.

object

**capabilities**

required

Capability tags supported by this model (e.g. `chat`, `tools`, `vision`).

Array\<string>

**created\_at**

required

Timestamp when this model was created (RFC 3339).

string format: date-time

**display\_name**

required

Human-readable display name. Safe to render in user-facing messages.

string

**enabled**

required

Whether this model is selectable. Controls UI visibility AND server-side resolution: `ProviderResolverService` requires `enabled = true`, and org default-model validation rejects disabled models. Disabled models stay visible in raw list endpoints (so admins can re-enable them) but cannot be used in active sessions or as a session/agent default.

boolean

**id**

required

Prefixed public identifier. See [ID Schema](https://everruns.com/docs/advanced/id-schema/).

string

**is\_favorite**

required

Whether this model is starred in the UI for quick access.

boolean

**model\_id**

required

Provider-side model identifier as sent on the wire (e.g. `gpt-5.2`, `claude-sonnet-5`).

string

**profile\_key**

required

Stable assigned profile identity.

string

**provider\_id**

required

Owning provider’s prefixed public identifier.

string

**service**

required

The typed service selected by this model.

string

Allowed values: chat decisions embeddings realtime images rerank

**source**

required

How this model entry was added (manually, discovered, or seeded as predefined).

string

Allowed values: manual discovered predefined

**updated\_at**

required

Timestamp when this model was last updated (RFC 3339).

string format: date-time

**allowed\_actions**

State-aware hypermedia actions the caller can take on this resource next (e.g. `cancel`, `events`, `update`). Omitted from the wire shape when empty so resources that haven’t opted into the convention don’t grow their payloads.

Array\<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

* **Error recovery** — `ErrorResponse.allowed_actions` carries `rel`s like `retry`, `retry-later`, `unarchive`, `get-existing` so the agent knows the right next call after a 4xx/429.
* **Entity hypermedia** — `WithUrls<T>.allowed_actions` carries state-aware `rel`s like `cancel`, `events`, `self`, `update` on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed `rel` vocabulary distinguishes them.

object

**hint**

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null

**href**

Absolute (preferred) or relative URL the caller may invoke directly. **Always present on entity hypermedia actions** (`WithUrls<T>.allowed_actions`); **optional on error-recovery actions** (`ErrorResponse.allowed_actions`) where the matching `operation_id` is enough and the URI is implicit from the failed call.

string | null

**method**

HTTP method to use against `href`. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null

**operation\_id**

OpenAPI `operationId` the caller should invoke. Lets an MCP client resolve the call without parsing `href`.

string | null

**rel**

required

Link relation describing the action. Examples: `self`, `cancel`, `pause`, `resume`, `events`, `retry`, `retry-later`, `unarchive`, `get-existing`, `delete`, `update`.

string

**schema\_ref**

OpenAPI `$ref` to the request-body schema, when the action takes one (e.g. `#/components/schemas/UpdateSessionRequest`). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null

**self\_url**

required

Full API endpoint URL for this resource.

string

**ui\_link**

required

Alias for `view_url`, used by command and MCP outputs.

string

**view\_url**

required

Full UI URL for viewing this resource.

string

##### Example

```json
{
  "data": [
    {
      "id": "model_01933b5a00007000800000000000001",
      "provider_id": "provider_01933b5a00007000800000000000001",
      "service": "chat",
      "source": "manual",
      "allowed_actions": [
        {
          "method": "POST"
        }
      ]
    }
  ]
}
```

### 400

Invalid provider ID