Add ad files

Agents put your images and videos in DATALYR’s ad file library first, then use them in ads. Every file in the library has an asset_id the agent reuses.

Pick how to send a file

Where the file is	What to do	Tool the agent uses
Attached in ChatGPT	Attach it to your message	`import_ad_assets` with the attached files
Online: Google Drive, Dropbox, or a direct file link	Paste the link	`import_ad_assets` with `urls`
In Claude, Claude Code or Codex, as a file the agent can read	Attach it, or name the path	`create_asset_upload`, an upload, then `finish_asset_upload`
Already in the library	Ask the agent to reuse it	`list_ad_assets`

import_ad_assets takes 1 to 20 files per call. The agent waits until each file’s status is ready before it makes an ad with it.

Link	Rule
Google Drive	Share the file as Anyone with the link. DATALYR converts the share link to a download. Files over 100 MB must be uploaded instead.
Dropbox	A shared link to the file itself, not a folder
Any other link	It must return the file, not a web page. `https` only, on a public address, with at most 3 redirects.

Upload from a sandbox

Ask for an upload slot

The agent calls create_asset_upload with the file’s type and exact size in bytes. It gets an upload URL and headers, valid for 15 minutes.

Upload the file

The agent sends the raw bytes with a PUT to that URL, with exactly those headers.

Finish

The agent calls finish_asset_upload. DATALYR checks the real type, size, dimensions and duration.

curl -X PUT --data-binary @spring-4x5.jpg \
  -H "Content-Type: image/jpeg" \
  "UPLOAD_URL_FROM_CREATE_ASSET_UPLOAD"

Rule	Detail
Files up to 95 MB	Upload to `api.datalyr.com`
Larger files	Upload to the storage host named in the upload URL
Claude	If the sandbox refuses the host, allow `api.datalyr.com` under Settings → Capabilities. Allow the storage host too for files over 95 MB.
The same file twice	`finish_asset_upload` returns the first copy’s `asset_id`. The agent uses that one.

Library limits

Kind	Types	Largest file
Image	JPEG, PNG, GIF, WebP	30 MB
Video	MP4, MOV	500 MB

DATALYR reads the type from the file’s bytes, never from its name. A file that doesn’t decode, or a video whose length can’t be read, fails with the reason. Re-export a failing video as MP4 (H.264). Each platform takes a narrower set than the library:

Platform	Images	Videos
Meta	JPEG or PNG	MP4 or MOV, 1 second to 241 minutes
TikTok	JPEG or PNG, at most 1440×2560 pixels	MP4 or MOV, 1 second to 10 minutes
Google Ads	JPEG, PNG or GIF, up to 5120 KB. Demand Gen logos up to 150 KB.	YouTube videos only, by video id. Uploaded video files aren’t used.

Shapes and minimum sizes per format are on Meta, TikTok and Google Ads. Before writing an ad, the agent calls get_ad_requirements for the exact rules of the ad set or ad group.

AI enhancements stay off

Each platform can change your creative with its own AI: crop, expand, add music, translate, or generate new versions. DATALYR sends every enhancement explicitly, and each is off unless you turn it on.

Source of the setting	Wins over
The ad’s own `enhancements` value	Everything
The workspace default in Settings → Ad publishing → Enhancements	The platform’s own default
Nothing set	Off

The preview’s Enhancements: line names each one that is on. To change the workspace defaults, open Enhancements, pick the platform, and turn each switch on or off. Agents can change these defaults with update_ad_publish_settings.

Every enhancement per platform

Platform	Enhancements
Meta	Adapt to placement, Visual touch-ups, Adjust brightness and contrast, Expand image, Generate backgrounds, Image animation, Add templates, Add overlays, Text improvements, Translate text, Translate text in images, Enhance CTA, Relevant comments, Add stickers, Reveal details over time, Dynamic description, Video auto-crop, Video filters, Expand video, Translate voiceover, Multi-advertiser ads
TikTok	Video quality enhancement, Music refresh, Image quality enhancement, Image resize
Google Ads, display and Demand Gen image ads	Generate image design versions, Generate animated images, Generate videos from assets, Asset enhancements (display), Auto-generated video (display)
Google Ads, Demand Gen video ads	Generate shorter videos, Generate vertical videos, Landing page text

Verify

Ask the agent: List my ad files.
Confirm your file appears with status ready and the width, height and duration you expect.
Open Settings → Ad publishing → Activity and confirm the Uploaded … entry.

When it does not work

Symptom	Cause	Fix
`Google Drive sent a web page, not the file`	The file isn’t shared publicly, or it’s over 100 MB.	Share as Anyone with the link, or upload it instead.
`Dropbox sent a web page, not the file`	The link points to a folder or a preview page.	Use a shared link to the file itself.
The upload is refused in Claude	The sandbox blocks `api.datalyr.com`.	Allow it under Settings → Capabilities.
`size_mismatch`	The upload’s size differs from the declared bytes.	Ask the agent to call `create_asset_upload` again with the exact size.
`This upload link is invalid or expired`	More than 15 minutes passed.	Ask the agent to start the upload again.
`Google takes images up to 5120 KB.`	The image is too large for Google Ads.	Export a smaller file.

Meta: image and video shapes per Meta format.
How agents publish: what the preview shows about files.
Agent ad tools: the file tools and their inputs.

Agents and MCP

Agent ads

API Reference

Analytics

Events and users

Attribution and revenue

Cohorts and funnels

Metrics

Query

Workspace

Keys and approvals

Conversion rules

Trackable links

Saved reports

Dashboards, analyses and share links

Session replay

Exports

Pick how to send a file

Upload from a sandbox

Library limits

AI enhancements stay off

Verify

When it does not work

Next

​Pick how to send a file

​Share a link

​Upload from a sandbox

​Library limits

​AI enhancements stay off

​Verify

​When it does not work

​Next

Pick how to send a file

Share a link

Upload from a sandbox

Library limits

AI enhancements stay off

Verify

When it does not work

Next