Sign in

b7b824605094

OpenAPI 3.0.32026-08-12383909.7 MB
api-ai-gateway

Update virtual model config

Update a virtual model config

patch/v1/ai-gateway/virtual-model-configs

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Response

ownerIdstring required

Team (owner) that owns this VMC.

virtualModelSlugstring required

Client-facing alias used as the model slug in Gateway calls.

displayNamestring

Human-readable name for UI.

descriptionstring

Optional description for UI.

deletedfalse | true required

Whether this VMC is soft-deleted.

statusstring required

UI lifecycle status: draft, active, or archived.

visibilitystring

Visibility in listings: public, internal, or stealth.

updatedBystring

User id that last updated this VMC.

kindstring required

VMC kind: alias, relay, or router.

baseUrlstring

For kind=relay: URL the gateway forwards requests to as a transparent proxy.

instanceIdstring

The concrete model-provider instance this VMC resolves to.

providerOrderstring[]

Ordered list of providers to try as fallbacks on failure.

providerOnlystring[]

Restrict routing to only these providers.

modelSlugstring

Canonical model slug this VMC maps to (e.g. "creator/model"). Not used by kind=router.

modelsstring[]

For kind=router: ordered candidates, model slugs or router references. Otherwise: fallback models.

selector'cost' | 'priority' | 'tps' | 'ttft'

For kind=router: how to order candidates.

requiresstring[]

For kind=router: capability tags a candidate must have.

byokCredentialIdsstring[]

BYOK credential IDs allowed for this VMC.

observabilityTagsstring[]

Observability tags attached to requests through this VMC.

sort'cost' | 'latency' | 'price' | 'throughput' | 'tps' | 'ttft'

Rank eligible providers by an attribute.

hasstring[]

Limit providers to those with these features.

caching'auto'

Use caching if available.

serviceTier'fast' | 'flex' | 'priority'

Service tier for providers that support it.

zeroDataRetentionfalse | true

Only use providers with zero data retention.

hipaaCompliantfalse | true

Only use HIPAA-compliant providers.

disallowPromptTrainingfalse | true

Only use providers that will not train on your prompts.

speed'fast'

Only use fastest providers with short timeouts.

allowFallbackFromFastfalse | true

Allow fallback from fast to standard providers on failure.

createdAtnumber required

Creation timestamp (epoch ms).

updatedAtnumber required

Last update timestamp (epoch ms).