--- title: "Update a style profile" method: PATCH path: "/v3/style_profiles/{style_profile_id}" tags: ["ManageStyleProfiles"] --- # Update a style profile `PATCH /v3/style_profiles/{style_profile_id}` ## Request - Base URL: `https://api.deepl.com` - URL: `https://api.deepl.com/v3/style_profiles/{style_profile_id}` - Auth: API key in header `Authorization` Update a style profile you own or that was shared with you for editing. Fields you leave out of the request body are not changed. A component list you send replaces the linked list in full. To add a glossary to a style profile that already links two, send all three IDs. To unlink all components in a list, send an empty list. Requires an API key with the `style_profiles:write` scope. ## Path parameters - `style_profile_id` string, uuid, required: A unique ID assigned to a style profile. ## Request body - object - `name` string: A new name for the style profile. At most 255 characters. An empty string is rejected with `400 Bad Request`. - `description` string: A new description for the style profile. At most 1000 characters. Send an empty string to clear it. - `industry` string: A new industry for the style profile. At most 255 characters. Send an empty string to clear it. - `glossary_ids` string[]: The IDs of the glossaries to link, highest priority first. The order only takes effect with `glossary_priority_order_enabled`. Replaces the linked glossaries in full. Send an empty list to unlink all of them. - `style_rule_ids` string[]: The IDs of the style rule lists to link. At most one style rule list per target language. Replaces the linked style rule lists in full. Send an empty list to unlink all of them. - `translation_memory_ids` string[]: The IDs of the translation memories to link. At most one translation memory per source language. Replaces the linked translation memories in full. Send an empty list to unlink all of them. - `glossary_priority_order_enabled` boolean: Whether the order of `glossary_ids` sets priority: when two linked glossaries define the same source term, the one listed first wins. When `false`, the order has no effect. ## Response `200` Returns the updated style profile. - StyleProfile - `style_profile_id` string, uuid, required: A unique ID assigned to a style profile. - `name` string, required: Name associated with the style profile. At most 255 characters. - `description` string: Free-text description of the style profile. At most 1000 characters. Omitted from the response when the style profile has no description. - `industry` string: The industry the style profile is written for. At most 255 characters. Omitted from the response when the style profile has no industry. - `glossary_ids` string[], required: The IDs of the glossaries linked to the style profile, highest priority first. The order only takes effect with `glossary_priority_order_enabled`. - `style_rule_ids` string[], required: The IDs of the style rule lists linked to the style profile. A style profile links at most one style rule list per target language. - `translation_memory_ids` string[], required: The IDs of the translation memories linked to the style profile. A style profile links at most one translation memory per source language. - `glossary_priority_order_enabled` boolean, required: Whether the order of `glossary_ids` sets priority: when two linked glossaries define the same source term, the one listed first wins. When `false`, the order has no effect. - `creation_time` string, date-time, required: The creation time of the style profile in the ISO 8601-1:2019 format (e.g.: `2021-08-03T14:16:18.329Z`). - `updated_time` string, date-time, required: The time of the last update to the style profile in the ISO 8601-1:2019 format (e.g.: `2021-08-03T14:16:18.329Z`). ## Other responses - `400`: The request was rejected and the style profile was not changed. This is returned for a malformed request body, for an empty `name`, for a value that is longer than the field allows, and for a component ID that is not a valid UUID or that names a component your account cannot access. The message names the list that contains the bad ID. - `401`: Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header. - `403`: Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header. This error is also returned when the API key is scoped but does not include the scope required for this endpoint. - `404`: The style profile could not be found. This is also returned for a style profile your account can view but not edit. - `429`: Too many requests. Please wait and resend your request. - `500`: Internal error. - `503`: Resource currently unavailable. Try again later. ## Changes - **2026-11-03** `c7c91cfac5c0`: 1 info - endpoint added [Operation history](https://skmtc.dev/deepl/apis/deepl-api-documentation/changes/v3/style_profiles/:style_profile_id/patch.md) --- [API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) - [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/deepl/apis/deepl-api-documentation/revisions/c7c91cfac5c0?raw)