---
title: "Update Model"
method: PUT
path: "/v1/models/{model_id}"
tags: ["Models"]
---

# Update Model

`PUT /v1/models/{model_id}`

## Path parameters

- `model_id` union, required
  - string, uuid
  - string

## Request body

- ModelUpdateRequest
  - `name` string, required
  - `display_name` string, nullable
  - `description` string, nullable
  - `api_key` string, nullable
  - `provider_config` Options
    - `api_key` string
    - `urlToFetch` string, nullable
    - `resourceName` string, nullable
    - `deploymentId` string, nullable
    - `apiVersion` string, nullable
    - `adAuth` string, nullable
    - `azureAuthMode` string, nullable
    - `azureManagedClientId` string, nullable
    - `azureEntraClientId` string, nullable
    - `azureEntraClientSecret` string, nullable
    - `azureEntraTenantId` string, nullable
    - `azureAdToken` string, nullable
    - `azureModelName` string, nullable
    - `workersAiAccountId` string, nullable
    - `customHost` string, nullable
    - `forwardHeaders` string[], nullable
    - `index` integer, nullable
    - `cache` union
      - string
      - object
    - `metadata` object, nullable
    - `requestTimeout` integer, nullable
    - `transformToFormData` boolean, nullable
    - `awsSecretAccessKey` string, nullable
    - `awsAccessKeyId` string, nullable
    - `awsSessionToken` string, nullable
    - `awsRegion` string, nullable
    - `awsAuthType` string, nullable
    - `awsRoleArn` string, nullable
    - `awsExternalId` string, nullable
    - `awsS3Bucket` string, nullable
    - `awsS3ObjectKey` string, nullable
    - `awsBedrockModel` string, nullable
    - `awsServerSideEncryption` string, nullable
    - `awsServerSideEncryptionKMSKeyId` string, nullable
    - `amznSagemakerCustomAttributes` string, nullable
    - `amznSagemakerTargetModel` string, nullable
    - `amznSagemakerTargetVariant` string, nullable
    - `amznSagemakerTargetContainerHostname` string, nullable
    - `amznSagemakerInferenceId` string, nullable
    - `amznSagemakerEnableExplanations` string, nullable
    - `amznSagemakerInferenceComponent` string, nullable
    - `amznSagemakerSessionId` string, nullable
    - `amznSagemakerModelName` string, nullable
    - `stabilityClientId` string, nullable
    - `stabilityClientUserId` string, nullable
    - `stabilityClientVersion` string, nullable
    - `huggingfaceBaseUrl` string, nullable
    - `vertexRegion` string, nullable
    - `vertexProjectId` string, nullable
    - `vertexServiceAccountJson` object, nullable
    - `vertexStorageBucketName` string, nullable
    - `vertexModelName` string, nullable
    - `filename` string, nullable
    - `afterRequestHooks` object[], nullable
    - `beforeRequestHooks` object[], nullable
    - `defaultInputGuardrails` object[], nullable
    - `defaultOutputGuardrails` object[], nullable
    - `openaiProject` string, nullable
    - `openaiOrganization` string, nullable
    - `openaiBeta` string, nullable
    - `azureDeploymentName` string, nullable
    - `azureApiVersion` string, nullable
    - `azureExtraParams` string, nullable
    - `azureFoundryUrl` string, nullable
    - `strictOpenAiCompliance` boolean, nullable
    - `mistralFimCompletion` string, nullable
    - `anthropicBeta` string, nullable
    - `anthropicVersion` string, nullable
    - `fireworksAccountId` string, nullable
    - `snowflakeAccount` string, nullable
    - `watsonxVersion` string, nullable
    - `watsonxSpaceId` string, nullable
    - `watsonxProjectId` string, nullable
    - `watsonxDeploymentId` string, nullable
    - `watsonxCpdUrl` string, nullable
    - `watsonxCpdUsername` string, nullable
    - `watsonxCpdPassword` string, nullable
  - `config` ModelConfigInput
    - `decoding_method` string, nullable
    - `prompt` union
      - string
      - string[]
    - `max_tokens` integer, nullable
    - `max_completion_tokens` integer, nullable
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `n` integer, nullable
    - `stream` boolean, nullable
    - `logprobs` integer, nullable
    - `top_logprobs` boolean, nullable
    - `echo` boolean, nullable
    - `stop` union
      - string
      - string[]
    - `presence_penalty` number, nullable
    - `frequency_penalty` number, nullable
    - `best_of` integer, nullable
    - `logit_bias` object, nullable
    - `user` string, nullable
    - `context` string, nullable
    - `examples` Examples[], nullable
      - `input` unknown, required
      - `output` unknown, required
    - `top_k` integer, nullable
    - `response_format` ResponseFormat
      - `type` string, required
      - `json_schema` unknown
    - `seed` integer, nullable
    - `store` boolean, nullable
    - `metadata` object, nullable
    - `modalities` string[], nullable
    - `audio` AudioConfig
      - `voice` string, required
      - `format` string, required
    - `service_tier` string, nullable
    - `prediction` Prediction
      - `type` string, required
      - `content` union, required
        - PredictionContent[]
          - `type` string, required
          - `text` string, required
        - string
    - `safety_settings` unknown
    - `anthropic_beta` string, nullable
    - `anthropic_version` string, nullable
    - `thinking` Thinking
      - `type` string, nullable
      - `budget_tokens` integer, required
    - `space_id` string, nullable
    - `project_id` string, nullable
    - `reasoning_effort` string, nullable
  - `tags` string[], nullable
  - `connection_id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/revisions/82c114c37196/schema)