Update Translation Style

Rename an owned custom style or replace its instructions. Changed instructions are safety-validated again and invalidate translations cached under this style. Built-in styles cannot be modified, and a custom style’s target language is immutable.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

translation_style_idstringRequired
Custom translation style ID.

Request

This endpoint expects an object.
namestringOptional
New display name. Omit to leave unchanged.
instructionsstringOptional

Replacement style-only instructions. Omit to leave unchanged.

Response

This endpoint returns an object.
idstring

Value to pass as translation_style when creating a translation.

namestring
Display name.
target_languageslist of enums
Languages this style can be used with.
Allowed values:
kindenum

Whether this is a built-in or user-created style.

Allowed values:
verifiedboolean
Whether the style instructions passed safety and scope validation.
descriptionstringOptional
Short description of the style.
instructionsstringOptional

The authenticated user’s custom style instructions. Omitted for built-in styles.

created_atdatetimeOptional
Creation time for a custom style.
updated_atdatetimeOptional
Last update time for a custom style.

Errors

400
Invalid Translation Style
401
Authentication Error
404
Translation Style Not Found
429
Rate Limit Error
503
Translation Style Validation Unavailable