---
title: "Replace a system custom font's match names (staff only)."
method: PUT
path: "/internal_api/system_fonts/{uuid}/match_names"
tags: ["custom_font"]
---

# Replace a system custom font's match names (staff only).

`PUT /internal_api/system_fonts/{uuid}/match_names`

## Request

- Base URL: `https://api.bluente.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bluente.com/internal_api/system_fonts/{uuid}/match_names`
- Auth: none declared
- TypeScript: <https://skmtc.dev/bluente/apis/bluente-api/docs/internal_api/system_fonts/:uuid/match_names/put.ts> (a function with typed inputs; its response is checked against the schema)

Set the original font names (e.g. Calibri) this system family stands in for on the native PDF route. An empty value clears them.

## Path parameters

- `uuid` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `match_names` string: comma-separated original font names, e.g. Calibri,Calibri Light; empty clears

## Response `200`

OK

- object
  - `code` integer: 0=success，only parse data when code=0
  - `data` object: real data
    - `coverage` string[]: expanded at read time, never stored
    - `family_name` string
    - `is_default` boolean
    - `languages` string[]: declared codes, verbatim
    - `match_names` string[]: MatchNames are a system font's original font names on the native PDF route; only the staff listing (ListSystem) fills them.
    - `owner_type` string
    - `read_only` boolean: ReadOnly marks a Bluente system font: usable (default font, font_uuid) but not deletable or editable by customers.
    - `styles` string[]
    - `uuid` string
  - `message` string: tip message

## Changes

- **2026-10-28** `429a9223fc3e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluente/apis/bluente-api/changes/internal_api/system_fonts/:uuid/match_names/put.md)

---

[API](https://skmtc.dev/bluente/apis/bluente-api.md) - [All operations](https://skmtc.dev/bluente/apis/bluente-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluente/apis/bluente-api/revisions/429a9223fc3e?raw)