---
title: "Get Workspace Models"
method: GET
path: "/workspaces/{workspace_id}/agent-models"
---

# Get Workspace Models

`GET /workspaces/{workspace_id}/agent-models`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/workspaces/{workspace_id}/agent-models`
- Auth: one of:
  - API key in cookie `fastapiusersauth`
  - HTTP bearer

Get models accessible to a workspace, and its default model.

Returns the full effective set; the list is bounded by org enablement
and is expected to be small, so pagination is not used here. The default
is the organization's default model, if it is enabled for this workspace.

## Path parameters

- `workspace_id` string, uuid, required

## Response `200`

Successful Response

- WorkspaceAgentModelListResponse: Models a workspace can use, and its default model.
  - `items` WorkspaceAgentModelRead[], required
    - `id` string, uuid, required
    - `custom_provider_id` string, uuid, nullable, required
    - `organization_id` string, uuid, nullable, required
    - `model_provider` string, required
    - `model_name` string, required
    - `model_metadata` object, nullable, required
    - `custom_provider_name` string, nullable
    - `custom_provider_base_url` string, nullable
  - `default_catalog_id` string, uuid, nullable: The organization's default model, if it is enabled for this workspace.
  - `has_org_default` boolean: Whether the organization has a default model, enabled here or not.
  - `workspace_subset_disabled` boolean: True when the workspace has a model subset and the organization has disabled every model in it.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)