Skip to content

docs: add style_profile_id to POST /v2/translate - #439

Merged
lawl-dev merged 3 commits into
docs/style-profiles-apifrom
docs/translate-style-profile-id
Oct 13, 2026
Merged

lawl-dev merged 3 commits into
docs/style-profiles-apifrom
docs/translate-style-profile-id

Conversation

@lawl-dev

@lawl-dev lawl-dev commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor

Stacked on #427 (style profile endpoints); retarget to main once that merges.

Documents style_profile_id on POST /v2/translate (JSON and form-encoded): the profile is applied per text once the source language is known, components that do not fit a text's language pair are left out without an error, and the parameter cannot be combined with the individual customization parameters (400). Unknown or inaccessible profiles return 404; accounts without style profiles get 400. Adds the style profiles row to the customize overview.

openapi.json regenerated from the YAML.

@lawl-dev lawl-dev changed the title docs: add style_profile_id to POST /v2/translate docs: add style_profile_id to POST /v2/translate and POST /v2/document Sep 15, 2026
@lawl-dev
lawl-dev force-pushed the docs/translate-style-profile-id branch from 5989929 to 1d9d9ef Compare September 15, 2026 08:54
@lawl-dev lawl-dev changed the title docs: add style_profile_id to POST /v2/translate and POST /v2/document docs: add style_profile_id to POST /v2/translate Sep 15, 2026
Maxim Brunnmeier added 3 commits October 13, 2026 15:31
A request names a style profile instead of listing its components. Documents how the profile is applied per text once the source language is known, that components which do not fit a text's language pair are left out, the exclusivity with the customizations object and the individual parameters (400), unknown profiles (404), and accounts without style profiles (403). Adds the style profiles row to the customize overview.
…iles

The translate endpoint rejects a gated style_profile_id with 400 Bad Request, like the customizations object.
Example documents and the customizations object ship later, so style_profile_id only names the components and conflicting parameters that are available now.
@lawl-dev
lawl-dev force-pushed the docs/translate-style-profile-id branch from 99e7431 to 31a8992 Compare October 13, 2026 13:31
@lawl-dev
lawl-dev merged commit 31a8992 into docs/style-profiles-api Oct 13, 2026
1 check passed
@lawl-dev
lawl-dev deleted the docs/translate-style-profile-id branch October 13, 2026 13:32

This branch was successfully deployed

1 active deployment
staging — 31a8992e Deployed Oct 13, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant