Skip to content

Create Font Upload

POST
/v1/fonts/uploads
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.

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 format: uuid
size
required
Size

The file's size in bytes; at most 20 MB.

integer
> 0
Examplegenerated
{
"content_type": "example",
"file_name": "example",
"scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"size": 1
}

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:<uuid> ref.

string
presigned_url
required
Presigned Url
string
scope_id
required
Any of:
string format: uuid
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>
ValidationError
object
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"
}
]
}