{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Register a custom font on a site and get a presigned S3 URL to upload the font binary.\n\nThe response includes a `customFont` object and an `upload` object. Use the `upload.url` and `upload.fields`\nto POST the font binary directly to S3 as `multipart/form-data`. The binary must go in a field named `file`\nand must be the last field in the form (an AWS S3 requirement). S3 returns `201 Created` on a successful upload.\n\nTo learn more, see [Custom fonts](/data/docs/custom-fonts).\n\nRequired scope | `sites:write`\n","properties":{"path":{"type":"object","properties":{"site_id":{"type":"string","examples":["580e63e98c9a982ac9b8b741"],"description":"Unique identifier for a Site"}},"required":["site_id"],"additionalProperties":false},"body":{"type":"object","description":"Information about the custom font to create","additionalProperties":false,"required":["fileName","fileHash","fontFamily","weight","italic","fontDisplay"],"properties":{"fileName":{"type":"string","description":"File name including extension. Accepted extensions are `.woff2`, `.woff`, `.ttf`, `.otf`, and `.eot`. Maximum 256 characters.","examples":["AcmeSans-Regular.woff2"]},"fileHash":{"type":"string","description":"Lowercase hex MD5 hash of the font binary (exactly 32 characters)","examples":["3c7d87c9575702bc3b1e991f4d3c638e"]},"fontFamily":{"type":"string","description":"The CSS font-family name (1-256 characters). Commas are stripped server-side.","examples":["Acme Sans"]},"weight":{"type":"integer","minimum":1,"maximum":1000,"description":"CSS font-weight value (1-1000)","examples":[400]},"italic":{"type":"boolean","description":"Whether the font is italic","examples":[false]},"fontDisplay":{"type":"string","enum":["auto","block","swap","fallback","optional"],"description":"CSS font-display value","examples":["swap"]},"axes":{"type":"array","maxItems":16,"items":{"description":"A variable font axis definition","required":["tag","min","max","defaultValue"],"properties":{"tag":{"type":"string","minLength":4,"maxLength":4,"pattern":"^[\\x20-\\x7E]{4}$","description":"The four-character OpenType axis tag, consisting of exactly 4 printable ASCII characters (for example, `wght`, `opsz`, `slnt`, `wdth`)","examples":["wght"]},"name":{"type":"string","maxLength":64,"description":"Optional human-readable label for the axis","examples":["Weight"]},"min":{"type":"number","description":"Minimum value for the axis","examples":[100]},"max":{"type":"number","description":"Maximum value for the axis","examples":[900]},"defaultValue":{"type":"number","description":"Default value for the axis. Must be between `min` and `max` (inclusive). Violating this constraint returns `400 BadArgument` with an error prefixed `fontMetadata.axes`.","examples":[400]}}},"description":"Variable font axes. Omit or pass an empty array for static fonts."}}}},"required":["path","body"],"additionalProperties":false},"name":"Create custom font","id":"webflow.create-custom-font","example":{"path":{"site_id":"580e63e98c9a982ac9b8b741"},"body":{"fileName":"AcmeSans-Regular.woff2","fileHash":"3c7d87c9575702bc3b1e991f4d3c638e","fontFamily":"Acme Sans","weight":400,"italic":false,"fontDisplay":"swap"}},"maxRequests":1,"summary":false}}