---
title: "Update Foundry Model"
method: PUT
path: "/admin/foundry-models/{model_id}"
tags: ["admin"]
---

# Update Foundry Model

`PUT /admin/foundry-models/{model_id}`

## Request

- Base URL: `https://api.oxlo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oxlo.ai/admin/foundry-models/{model_id}`
- Auth: HTTP bearer

Update an existing foundry model configuration.
Only provided fields will be updated.

## Path parameters

- `model_id` string, required

## Request body

- FoundryModelUpdate: Schema for updating an existing FoundryModel. All fields optional.
  - `name` string, nullable
  - `target_model` string, nullable
  - `provider` string, nullable
  - `query_method` string, nullable
  - `context_length` integer, nullable
  - `quantization` string, nullable
  - `gpu_requirement` string, nullable
  - `tier` string, nullable
  - `owned_by` string, nullable
  - `coming_soon` boolean, nullable
  - `tags` string[], nullable
  - `size` string, nullable
  - `category` string, nullable
  - `description` string, nullable
  - `rate_limit_requests` integer, nullable
  - `rate_limit_tokens` integer, nullable
  - `rate_limit_window_seconds` integer, nullable
  - `fallback_to_next_endpoint` boolean, nullable
  - `testable_in_playground` boolean, nullable
  - `is_active` boolean, nullable
  - `query_handler` string, nullable
  - `endpoint_config` object, nullable
  - `use_foundry_endpoints` boolean, nullable

## Response `200`

Successful Response

- FoundryModelResponse: Schema for FoundryModel response.
  - `name` string, required: Display name for the model
  - `target_model` string, required: Target model name for API calls
  - `provider` string, required: Provider: 'azure', 't4'
  - `query_method` string, required: Query method: 'openai_chat', 'rest_flux-2-pro', etc.
  - `context_length` integer: Context window length (0 for non-LLM)
  - `quantization` string, nullable: Quantization: 'fp16', 'Q8_0', etc.
  - `gpu_requirement` string, nullable: GPU requirement: 'oxlo', 'A100', 'T4'
  - `tier` string: Access tier: 'free', 'pro', 'premium'
  - `owned_by` string: Owner: 'oxlo', 'worker-local'
  - `coming_soon` boolean: Whether the model is not yet available
  - `tags` string[], nullable: Tags for categorization
  - `size` string, nullable: Model size: '70B', 'unknown'
  - `category` string: Category: 'chat', 'image', 'audio', etc.
  - `description` string, nullable: Description for UI/docs
  - `rate_limit_requests` integer, nullable: Rate limit: requests per window
  - `rate_limit_tokens` integer, nullable: Rate limit: tokens per window
  - `rate_limit_window_seconds` integer, nullable: Rate limit window in seconds
  - `fallback_to_next_endpoint` boolean: Try next endpoint on rate limit
  - `testable_in_playground` boolean: Available in playground UI
  - `is_active` boolean: Whether model is active and loaded
  - `query_handler` string, nullable: Handler function name: 'openai_chat', 'flux_image', 'anthropic_messages', 'rest_generic'
  - `endpoint_config` object, nullable: Flexible endpoint configuration with endpoints, path, auth_type, timeout, etc.
  - `use_foundry_endpoints` boolean: If true, use Foundry endpoint rotation; if false, use endpoint_config.endpoints
  - `id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxlo/apis/oxlo-backend.md) - [All operations](https://skmtc.dev/oxlo/apis/oxlo-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/oxlo/apis/oxlo-backend/revisions/bc2ecdc94f31?raw)