Import asset
Import an asset in a single call, either from a remote sourceUrl (fetched server-side) or from inline contentBase64 (max 10MB decoded). Returns the created asset; thumbnailing and enrichment run asynchronously. For large or local files, use the presigned requestUpload/confirmUpload flow instead so the bytes go directly to storage.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Body
Public http(s) URL the server fetches the file from (SSRF-guarded, max 200 MB); mutually exclusive with contentBase64.
1"https://example.com/media/launch-teaser.png"
Base64-encoded file content for small payloads, max 10 MB decoded; mutually exclusive with sourceUrl, and requires fileName and mimeType.
1"iVBORw0KGgoAAAANSUhEUg..."
Filename to store the asset under, including extension; required with contentBase64, otherwise derived from sourceUrl.
1"launch-teaser.png"
MIME type of the imported content; required with contentBase64, otherwise inferred from the fetch response.
1"image/png"
Folder to place the newly imported asset in; must exist and belong to the team. Omit to land the asset at the team root.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$