Runtype APIModel Configs

Update model configuration

Update fields on an existing model configuration.

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.
isDefaultbooleanOptional
isEnabledbooleanOptional
providerKeyIdstringOptional

Credential selector: platform, a provider-key ID, or an organization-connection ID. For migrated model providers this stores the model reference without changing organization-wide credential policy.

settingsobjectOptional

Response

Updated model configuration
createdAtstring
idstring
isDefaultboolean
isEnabledboolean
modelIdstring
organizationIdstring or null
providerstring
providerKeyIdstring or null

Previous-Worker-compatible provider-key alias. Updated organization clients should use organizationConnectionId; platform selection is null.

settingsmap from strings to any
updatedAtstring
userIdstring or null

Legacy actor owner for personal/compatibility rows. Null for organization-owned model configurations.

configScopestringOptional
configurationStatusenumOptional

Organization configuration readiness. needs_configuration means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row.

costPer1kTokensdoubleOptional
createdByUserIdstring or nullOptional

Nullable creation provenance for organization-owned model configurations; never authorization or execution authority.

creatorstringOptional
creatorDisplayNamestring or nullOptional
creditPromoLabelstring or nullOptional

Plain-language discount callout for this model, e.g. “90% off”. null when undiscounted.

creditPromoMultiplierdoubleOptional

Factor platform-key spend on this model is billed at while a credit promo is active (0.1 = 90% off). 1 when no discount applies.

displayNamestringOptional
inputCostPer1kTokensdoubleOptional
keyStatusenumOptional
maxOutputTokensdoubleOptional
migrationCandidateCountintegerOptional>=0
Number of preserved legacy candidates considered during organization migration. Candidate settings remain internal.
organizationConnectionIdstring or nullOptional

Normalized organization-owned connection reference. Null for platform selection, personal credentials, and providers that have not migrated.

outputCostPer1kTokensdoubleOptional
reasoningCapabilityobjectOptional
supportedResponseFormatslist of stringsOptional
supportsCustomKeybooleanOptional
supportsSearchbooleanOptional
supportsStreamingbooleanOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error