--- title: Create Font Upload | Luma Agents --- POST /v1/fonts/uploads Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/fonts/uploads'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"content_type":"example","file_name":"example","scope_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","size":1}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```sh curl --request POST \ --url https://agents.lumalabs.ai/v1/fonts/uploads \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "content_type": "example", "file_name": "example", "scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "size": 1 }' ``` - Productionagents.lumalabs.ai/v1/fonts/uploads Start a font upload: PUT the file's raw bytes to `presigned_url` before `expires_at`, then complete it. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Request Bodyrequired Media typeapplication/json *FontUploadRequest* What the caller is about to upload. The bytes themselves decide the font's family, weight and style. object **content\_type** required *Content Type* The file's media type, e.g. `font/woff2`. Informational. string \>= 1 characters <= 255 characters **file\_name** required *File Name* Must end in .ttf, .otf, .woff or .woff2. string \>= 1 characters <= 255 characters **scope\_id** Any of: - [string](#tab-panel-0-0) - [null](#tab-panel-0-1) string format: uuid null **size** required *Size* The file's size in bytes; at most 20 MB. integer \> 0 ##### Examplegenerated ```json { "content_type": "example", "file_name": "example", "scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "size": 1 } ``` ## Responses ### 201 Successful Response Media typeapplication/json *FontUploadSlot* Where to PUT the bytes, and the face to complete once they are there. object **expires\_at** required *Expires At* string format: date-time **face\_id** required *Face Id* A `font_face:` ref. string **presigned\_url** required *Presigned Url* string **scope\_id** required Any of: - [string](#tab-panel-1-0) - [null](#tab-panel-1-1) string format: uuid null ##### Examplegenerated ```json { "expires_at": "2026-04-15T12:00:00Z", "face_id": "example", "presigned_url": "example", "scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" } ``` ### 422 Validation Error Media typeapplication/json *HTTPValidationError* object **detail** *Detail* Array\ *ValidationError* object **ctx** *Context* object **input** *Input* **loc** required *Location* Array **msg** required *Message* string **type** required *Error Type* string ##### Examplegenerated ```json { "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ] } ```