Create Font Upload
POST
/v1/fonts/uploads
const url = 'https://agents.lumalabs.ai/v1/fonts/uploads';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', '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);}curl --request POST \ --url https://agents.lumalabs.ai/v1/fonts/uploads \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "content_type": "example", "file_name": "example", "scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "size": 1 }'Start a font upload: PUT the file's raw bytes to presigned_url before expires_at, then complete it.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “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
Examplegenerated
{ "content_type": "example", "file_name": "example", "scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "size": 1}Responses
Section titled “ Responses ”Successful Response
Media typeapplication/json
FontUploadSlot
Where to PUT the bytes, and the face to complete once they are there.
object
Examplegenerated
{ "expires_at": "2026-04-15T12:00:00Z", "face_id": "example", "presigned_url": "example", "scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Validation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{ "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ]}