Skip to main content
GET
Read uploaded creative media

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.

uploadId
string
required

Identifier returned by the matching Bily read or creation operation.

Query Parameters

variant
enum<string>
Available options:
image,
thumbnail
dpr
enum<string>

Only valid with variant=thumbnail. Omit for the original media.

Available options:
2

Response

Authenticated media bytes.

The response is of type file.