Skip to main content
POST
Reserve a Creative Reference Upload

Authorizations

x-api-key
string
header
required

A server-side Bily API key created under Settings > AI tools > Access keys. Select the intended workspace before creating it.

Headers

x-bily-organization-id
string

An organization ID returned by GET /context or GET /organizations. Omit it when a scoped key supplies the organization. Otherwise provide it when no organization is selected.

Example:

"org_01J8W7T9G3E6ZQ4M2K5N8P1R0S"

Path Parameters

storeUrl
string
required

Exact workspace URL returned by GET /context.

Body

application/json
idempotencyKey
string
required
Required string length: 1 - 256
Pattern: ^[A-Za-z0-9._~-]+$
fileName
string
required
Required string length: 1 - 240
contentType
enum<string>
required
Available options:
image/jpeg,
image/png,
image/webp,
video/mp4,
video/quicktime,
video/webm
sizeBytes
integer
required
Required range: 1 <= x <= 99614720

Response

Request completed. Inspect the returned state and any verification fields.

upload
object
required
Example:
uploadUrl
string
reused
boolean