---
title: "Fetch models from a provider"
method: POST
path: "/model-registry-service/providers/{providerId}/fetch-models"
tags: ["Model Registry Service"]
---

# Fetch models from a provider

`POST /model-registry-service/providers/{providerId}/fetch-models`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/model-registry-service/providers/{providerId}/fetch-models`
- Auth: none declared

Validates a credential and retrieves the available models from the provider.

## Path parameters

- `providerId` string, required

## Request body

- object
  - `credential` union
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential0
      - `type` 'openai', required
      - `apiKey` string, required
      - `baseURL` string
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential1
      - `type` 'anthropic', required
      - `apiKey` string, required
      - `baseURL` string
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential2
      - `type` 'google', required
      - `apiKey` string, required
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential3
      - `type` 'ollama', required
      - `baseURL` string
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential4
      - `type` 'bedrock', required
      - `config` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf4Config, required
        - `region` string, required
        - `accessKeyId` string, required
        - `secretAccessKey` string, required
        - `iamRole` string
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential5
      - `type` 'bedrock-proxy', required
      - `config` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf5Config, required
        - `serviceUrl` string, required
        - `tokenUrl` string, required
        - `clientId` string, required
        - `clientSecret` string, required
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential6
      - `type` 'databricks', required
      - `config` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf6Config, required
        - `type` 'oauth-m2m', required
        - `host` string, required
        - `clientId` string, required
        - `clientSecret` string, required
    - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredential7
      - `type` 'gateway-manager', required
      - `config` union, required
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config0
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf0
          - `backendProvider` 'openai', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf0Credential, required
            - `apiKey` string, required
            - `baseURL` string
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config1
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf1
          - `backendProvider` 'anthropic', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf1Credential, required
            - `apiKey` string, required
            - `baseURL` string
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config2
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf2
          - `backendProvider` 'google', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf2Credential, required
            - `apiKey` string, required
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config3
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf3
          - `backendProvider` 'mistral', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf3Credential, required
            - `apiKey` string, required
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config4
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf4
          - `backendProvider` 'ollama', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf4Credential, required
            - `baseURL` string
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config5
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf5
          - `backendProvider` 'bedrock', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf5Credential, required
            - `region` string, required
            - `accessKeyId` string, required
            - `secretAccessKey` string, required
            - `iamRole` string
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config6
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf6
          - `backendProvider` 'bedrock-proxy', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf6Credential, required
            - `serviceUrl` string, required
            - `tokenUrl` string, required
            - `clientId` string, required
            - `clientSecret` string, required
        - ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7Config7
          - `clusterId` string, required
          - `properties` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf7
          - `backendProvider` 'databricks', required
          - `credential` ModelRegistryServiceProvidersProviderIdFetchModelsPostRequestBodyContentApplicationJsonSchemaCredentialOneOf7ConfigOneOf7Credential, required
            - `authType` 'azure-client-secret', required
            - `clientId` string, required
            - `clientSecret` string, required
            - `tenantId` string, required
            - `workspaceUrl` string, required
            - `resourceId` string
  - `profileId` string, nullable

## Response `200`

The fetched models and validation result.

- ModelRegistryServiceFetchModelsResponse200
  - `success` boolean, required
  - `models` ModelRegistryServiceProvidersProviderIdFetchModelsPostResponsesContentApplicationJsonSchemaModelsItems[], required
    - `id` string, required
    - `name` string, required
    - `enabled` boolean, required
    - `status` 'active' | 'disabled' | 'deprecated', required
    - `modelVariables` ModelRegistryServiceProvidersProviderIdFetchModelsPostResponsesContentApplicationJsonSchemaModelsItemsModelVariables
  - `error` ModelRegistryServiceProvidersProviderIdFetchModelsPostResponsesContentApplicationJsonSchemaError
    - `type` 'auth' | 'network' | 'timeout', required
    - `message` string, required
  - `retrievedAt` string, required

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Model Registry Service` added
  - api tag `modelRegistryService` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/model-registry-service/providers/:providerId/fetch-models/post.md)

---

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