> ## Documentation Index > Fetch the complete documentation index at: https://docs.airmux.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Workspace Model Catalog > Return the provider and model catalog available to a workspace. Required permission: `catalog.read`. ## OpenAPI ````yaml /lib/api-spec/openapi.yaml get /api/v1/organizations/{org_id}/workspaces/{workspace_ref}/taxonomy openapi: 3.1.0 info: title: airmux Control Plane API description: > Manage airmux organizations, workspaces, management keys, provider credentials, and data-plane synchronization. Organization and workspace targets are part of each URL. Successful responses wrap their result in `{"data": ...}`. Authenticate with a control-plane management key or a browser session as documented by each operation. Inference keys authenticate model requests at the data plane and are not accepted here. version: 0.1.0 servers: [] security: [] tags: - name: Auth description: Sign in human users, manage browser sessions, and authorize the CLI x-displayName: Authentication - name: Enrollment description: List a user's organizations and create their personal organization - name: Instance Organizations description: List and create organizations on this airmux instance x-displayName: Organizations - name: Instance Users description: Manage human users and service accounts across the instance x-displayName: Users - name: Instance Management Keys description: >- List management keys across the instance, issue instance-scoped credentials, and revoke keys x-displayName: Management Keys - name: Instance Model Catalog description: Manage the providers and models available through this airmux instance x-displayName: Model Catalog - name: Instance Provider Credentials description: Manage provider API keys available across the airmux instance x-displayName: Provider Credentials - name: Data Plane Instances description: Inspect connected data-plane instances x-displayName: Data Planes - name: Instance Activity description: Inspect recent audited changes across the instance x-displayName: Activity - name: OSS description: Bootstrap a new self-hosted airmux deployment x-displayName: Self-hosting - name: Organization Settings description: View, update, and delete one organization x-displayName: Settings - name: Organization Members description: Manage organization membership and organization roles x-displayName: Members - name: Organization Service Accounts description: >- Create and delete organization-managed machine principals and their initial management credentials x-displayName: Service Accounts - name: Organization Invitations description: Invite human users to an organization and optionally one workspace x-displayName: Invitations - name: Organization Workspaces description: List and create workspaces within an organization x-displayName: Workspaces - name: Organization Management Keys description: >- List management keys within an organization, issue organization-scoped credentials, and revoke keys x-displayName: Management Keys - name: Organization Provider Credentials description: Manage provider API keys available across an organization x-displayName: Provider Credentials - name: Organization Usage Events description: Inspect usage events across an organization x-displayName: Usage Events - name: Organization Reports description: Explore usage and requests across an organization or one workspace x-displayName: Reports - name: Organization Activity description: Inspect recent audited changes in an organization x-displayName: Activity - name: Organization Model Catalog description: Inspect the provider and model catalog available to an organization x-displayName: Model Catalog - name: Workspace Settings description: View, update, and delete one workspace x-displayName: Settings - name: Workspace Policies description: Manage workspace inference restrictions and fallbacks x-displayName: Policies - name: Workspace Members description: Manage workspace membership and workspace roles x-displayName: Members - name: Workspace Management Keys description: List and issue management keys scoped to a workspace and revoke keys x-displayName: Management Keys - name: Workspace Playground description: Create and end short-lived browser sessions for playground model requests x-displayName: Playground - name: Workspace Inference Keys description: Issue and revoke credentials for model requests to a workspace x-displayName: Inference Keys - name: Workspace Provider Credentials description: Manage provider API keys available to one workspace x-displayName: Provider Credentials - name: Workspace Usage Events description: Inspect usage events for one workspace x-displayName: Usage Events - name: Workspace Model Catalog description: Inspect the provider and model catalog available to a workspace x-displayName: Model Catalog - name: Data Plane API description: Poll bundles, ingest usage events, and record data-plane heartbeats x-displayName: Synchronization paths: /api/v1/organizations/{org_id}/workspaces/{workspace_ref}/taxonomy: get: tags: - Workspace Model Catalog summary: Get Workspace Model Catalog description: |- Return the provider and model catalog available to a workspace. Required permission: `catalog.read`. operationId: get_workspace_taxonomy parameters: - name: workspace_ref in: path required: true schema: type: string title: Workspace Ref description: Workspace ID or slug - name: org_id in: path required: true schema: type: string title: Org Id description: Organization ID or slug responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Envelope_TaxonomyOut_' '401': description: Authentication failed '403': description: The credential does not have the required permission '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - ManagementKey: [] - SessionCookie: [] components: schemas: Envelope_TaxonomyOut_: properties: data: $ref: '#/components/schemas/TaxonomyOut' type: object required: - data title: Envelope[TaxonomyOut] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TaxonomyOut: properties: providers: items: $ref: '#/components/schemas/ProviderOut' type: array title: Providers models: items: $ref: '#/components/schemas/ModelOut' type: array title: Models type: object required: - providers - models title: TaxonomyOut ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ProviderOut: properties: id: type: string format: uuid title: Id name: type: string title: Name kind: type: string title: Kind base_url: type: string title: Base Url icon: type: string title: Icon param_aliases: additionalProperties: type: string type: object title: Param Aliases accepted_params: anyOf: - items: type: string type: array - type: 'null' title: Accepted Params params_closed: type: boolean title: Params Closed created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - name - kind - base_url - icon - param_aliases - accepted_params - params_closed - created_at - updated_at title: ProviderOut ModelOut: properties: id: type: string format: uuid title: Id name: type: string title: Name provider_id: type: string format: uuid title: Provider Id upstream_model: type: string title: Upstream Model egress_kind: anyOf: - type: string - type: 'null' title: Egress Kind input_price_per_mtok: type: string pattern: ^\d+(?:\.\d+)?$ title: Input Price Per Mtok output_price_per_mtok: type: string pattern: ^\d+(?:\.\d+)?$ title: Output Price Per Mtok cache_read_price_per_mtok: type: string pattern: ^\d+(?:\.\d+)?$ title: Cache Read Price Per Mtok cache_write_price_per_mtok: type: string pattern: ^\d+(?:\.\d+)?$ title: Cache Write Price Per Mtok context_window: type: integer title: Context Window max_output_tokens: anyOf: - type: integer - type: 'null' title: Max Output Tokens input_modalities: items: type: string enum: - text - image - audio - video - pdf type: array title: Input Modalities output_modalities: items: type: string enum: - text - image - audio - video - pdf type: array title: Output Modalities capabilities: items: type: string enum: - streaming - tools - reasoning - structured_output type: array title: Capabilities parameter_support: additionalProperties: type: string enum: - supported - unsupported type: object title: Parameter Support created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - name - provider_id - upstream_model - egress_kind - input_price_per_mtok - output_price_per_mtok - cache_read_price_per_mtok - cache_write_price_per_mtok - context_window - max_output_tokens - input_modalities - output_modalities - capabilities - parameter_support - created_at - updated_at title: ModelOut securitySchemes: ManagementKey: type: http description: >- A control-plane management key using the `sk-cp-` prefix. Inference keys are not accepted by control-plane endpoints. scheme: bearer SessionCookie: type: apiKey in: cookie name: airmux_session description: >- Browser session cookie returned by login or signup. Browser requests must also send `X-Requested-With`. ````