---
title: "Get Workspace Model Access"
method: GET
path: "/workspaces/{workspace_id}/agent-model-access"
---

# Get Workspace Model Access

`GET /workspaces/{workspace_id}/agent-model-access`

## Request

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

Get a workspace's model subset and the organization models it can use.

## Path parameters

- `workspace_id` string, uuid, required

## Response `200`

Successful Response

- WorkspaceAgentModelAccessRead: A workspace's model subset and the organization models it can pick from.
  - `inherit_all` boolean, required: True when the workspace has no subset and uses every organization-enabled model.
  - `catalog_ids` string[], required: Catalog IDs in the workspace's subset. Empty when inherit_all is true.
  - `candidates` WorkspaceAgentModelCandidate[], required: Models enabled for the organization. Provider URLs are left out: they can carry credentials, and a candidate may sit outside the workspace's subset.
    - `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

## 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)