Skip to main content
POST
Upload Assets
Upload one or more images with semantic usage metadata. Every file in a request shares the same metadata; send separate requests when assets need different roles, scopes, or instructions. Roles are brand_logo, reference_image, content_image, and background. Scopes are all_slides and generation. Save the returned asset IDs and pass them to generate or edit operations.

Authorizations

Authorization
string
header
required

Your Alai API key. Get one from your account settings at app.getalai.com

Path Parameters

presentation_id
string
required

Body

multipart/form-data
files
file[]
required
metadata
string
default:{}

Response

Successful Response

id
string
required
name
string
required
file_path
string
required
role
enum<string>
required
Available options:
brand_logo,
reference_image,
content_image,
background
scope
enum<string>
required
Available options:
all_slides,
generation
instructions
string | null