Upload Brand Font
upload_brand_fontStage a single-use custom font for a brand edit. Returns font_asset_id, family, format, weight, variable, and expires_at. The asset expires after 24 hours, and the consuming edit must finish preparing before expires_at. The asset is deleted when the candidate is stored, preparation fails, or the work becomes stale. Upload it again for a later edit.
Pass either a public TTF, OTF, WOFF, or WOFF2 URL, or a completed temporary
upload. For a local file, first call create_upload_urls, PUT the raw bytes as
directed, and pass the resulting upload_id here. Staging does not change the active brand. To use
the uploaded font, pass its font_asset_id and exact returned family in an exact
profile typography change with create_brand_edit. Family matching is
case-sensitive after trimming.
Pass exactly one of font_url or upload_id.
Args:
brand_session_id: Brand session ID fromlist_brands.font_url: Public font URL, max 5MB.upload_id: Completed temporary upload containing the font file.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"brand_session_id": "<brand_session_id>"
},
"name": "upload_brand_font"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| font_url | No | Public URL of the custom font to stage for a Brand Edit. The file must be TTF, OTF, WOFF, or WOFF2 and no larger than 5MB. Supply this URL or upload_id, but not both. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| upload_id | No | Completed temporary upload containing the custom font to stage. Obtain its ID from create_upload_urls or get_file_picker_handoff, and supply it instead of font_url. | |
| brand_session_id | Yes | Brand session ID from `list_brands`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| family | Yes | Font family name. Pass it unchanged as family in the typography change. | |
| format | Yes | Font file format. | |
| weight | Yes | Font weight, or the default weight of a variable font. | |
| variable | Yes | Whether the file is a variable font. | |
| expires_at | Yes | Expiry timestamp for this single-use font asset. The consuming brand edit must finish preparing before this time; starting before expiry is not sufficient. | |
| font_asset_id | Yes | Font asset ID. Pass it as font_asset_id in a create_brand_edit typography change. |