Kontainer

Update many folders in one call. Items are applied independently — a failure on one is reported in `failed` and the rest still apply.

bulk-update-folder

Update many users in one call. Pass `users` as an array; each entry is a single update-user request: { user_id, name, email, active, ... }. Items are applied independently — a failure on one is reported in `failed` and the rest still apply.

bulk-update-user

Move or copy files and/or folders into a destination folder. Actions: 'move' relocates items (originals disappear from their source); 'copy' duplicates them; 'archive-move' moves items across the archive boundary — use when the user asks to archive assets (destination is an archived folder) or restore them from archive (sources are archived, destination is not). Archive moves are destructive: they strip album/collection references and other runtime links. Every source must be on the same side of the archive boundary (all archived, or all not archived). Requires the Archive feature to be enabled on the client. Handle name collisions with file_conflict_resolution: 'rename' (default — keep both), 'skip', or 'overwrite'. Only file and folder resource types are accepted in `sources`.

transfer-to-folder

Create a new album (a.k.a. collection) — a curated selection of files drawn from any folders in the DAM, without moving the originals. Use when the user asks to "make a collection", "build a selection for the press release", "group these photos for a campaign", or "share a curated set". The album starts empty; files are added to it separately.

create-album

Create a level-0 item (a product record) under one variation of a PIM category. The item's display name is the value of its variation level's representative element, which is rarely keyed "name". Channel projections sync automatically. Returns the item id and display name.

create-category-item

Create a child variation item under an existing PIM category item, with its own element values, for SKU-level variants (size, colour, market) that diverge from the parent. The child variation level is the one below the parent's. Returns the created item.

create-category-variation-item

Create a top-level item in a PIM channel (e.g. the webshop copy of a product with its own translated title or channel-only images), under one of the channel's variations. Returns the created item.

create-channel-item

Create a child variation item under an existing PIM channel item, with its own element values, for channel-level variants (e.g. one size or colour entry per SKU for a marketplace). The child variation level is the one below the parent's. Returns the created item.

create-channel-variation-item

Enable CDN streaming for a video file — triggers transcoding to streaming-friendly formats and makes the file embeddable. Use when the user asks to "make this video streamable", "enable CDN for playback", or "get an embed code for a video". Requires the CDN feature.

create-file-cdn-video

Add a subtitle track to a video or audio file, from cues given as JSON or from the text of a SubRip (.srt) file. A file published on the video CDN shows the track in its public player.

create-file-subtitle

Create a new folder (or sub-folder) in the asset library — for a campaign, project, brand, partner, etc. Requires a parent folder and a unique name within that parent. Optional: description, layout flags (show_large_folder_name, hide_folder_name, thumbs_scale_to_fit, apply_folder_image_hue), thumbnail file.

create-folder

Create a child variation item under an existing PIM category item from a JSON:API resource object, for market-, language- or attribute-specific versions (EU vs US copy, colour variants). The child variation level is the one below the parent's. Returns the created item's id and name.

create-item-variation

Create a mirror folder under a parent folder.

create-mirror-folder

Create a new PIM resource — a reusable data record (e.g., brand, manufacturer, material) that items can reference via a resource-typed element instead of inlining the same data repeatedly. Use when the user asks to "add a brand", "register a supplier", or "define a new material" for the catalog. Resources are scoped to one category.

create-pim-resource

Create a smart folder under a parent folder: a folder whose contents are every file matching a filter, kept up to date automatically. Client admins only. Give source_folders, filter_config, or both.

create-smart-folder

Start AI transcription of a video or audio file into subtitle tracks. The spoken language is transcribed and every other requested language is translated from it. Runs in the background and can take minutes; the returned generation id reports its progress. A file published on the video CDN shows the new tracks in its public player.

create-subtitle-generation

Get a signed URL, valid for 15 minutes, that uploads one file into a folder when you send the bytes to it from your code sandbox — the way to put back a file you downloaded and edited, or any file you generated, without base64-encoding it into a tool call. Send the file with `curl -sS -T <local-file> "<upload_url>"` (raw PUT) or `curl -sS -F file=@<local-file> "<upload_url>"` (multipart POST); no auth header is needed. The response is JSON with the new file's id. Files over 500 MB are refused. The file name and conflict mode are fixed when the URL is created. Handle name collisions with file_conflict_resolution: 'rename' (default — keep both) or 'overwrite' (replace the existing file of the same name, e.g. when saving an edited version back). Ask the user before overwriting, since it cannot be undone.

create-upload-url

Create a new user account in the Kontainer workspace. Use when an admin asks to "add a user", "invite a teammate", or "onboard a colleague". Email must be unique within the client. Set sendInvite=true to email the new user a link to set their password (recommended for most flows). Group membership and folder access are granted separately after creation. Requires administrator privileges.

create-user

Create a new user group. Groups are the recommended way to manage folder permissions at scale — grant access to a group once, then add/remove members. Use when the user asks to "create a team", "add a department", or "set up a new client group". Optional flags control per-group capabilities: folder sharing, internal sharing, CDN activation with download. Members and folder access are added separately after creation. Requires administrator privileges.

create-user-group

Permanently delete a PIM category item (product). Irreversible. Fails if the item is referenced as a resource in other items. Deleting also removes any variations of this item and its channel-item counterparts across all channels. Check the item's external references and channel items first to gauge the downstream impact.

delete-category-item

Remove an item from a PIM channel (unpublishes it from that channel only — the underlying category item stays intact). Irreversible. Fails if this channel item is referenced as a resource in other items. Use when the user asks to "unpublish this from the webshop", "remove from the French store", or "pull this listing".

delete-channel-item

Move a file to trash (soft delete). The file must not already be trashed and the user needs delete access on the original folder. Deleting can break external references to the file; a trashed file can be restored later.

delete-file

Disable CDN streaming for a video file — removes the transcoded renditions and breaks any existing embed codes. Irreversible, and an embed that is live on a public page stops working. The underlying source video remains untouched and can have CDN streaming enabled again later.

delete-file-cdn-video

Delete a subtitle track and all its cues from a file. Irreversible. A file published on the video CDN loses the track from its public player.

delete-file-subtitle

Delete an empty folder. Fails if the folder has sub-folders, files with external references, is locked, or already in the trash. Requires delete access.

delete-folder

Remove a file's custom thumbnail and fall back to the auto-generated preview. Use when the user asks to "reset the thumbnail", "revert to the default preview", or "remove the custom thumbnail". The underlying file is not affected; only the custom preview image is deleted. A replacement custom thumbnail can be uploaded again later.

delete-thumbnail

Permanently delete a regular (single) user account. Does NOT work on shared users or administrators — those return "resource not found"; tell the user shared/admin accounts can't be deleted here. Irreversible. Removes the user's group memberships and folder permissions; historical activity (uploads, operation logs) is preserved under the deleted user's name. To revoke access temporarily instead, deactivate the user (active=false). Requires administrator privileges.

delete-user

Permanently delete a user group. Irreversible. Deleting a group revokes every folder permission granted via it; members themselves are not deleted but lose the group's access. Requires administrator privileges.

delete-user-group

Get the full original file (not a thumbnail) so you can use it: insert a logo into a document you generate, edit an image, convert a file, then upload the result back into a folder. Always returns `download_url`, a signed link valid for 15 minutes that needs no authentication — fetch it from your code sandbox (e.g. `curl -L -o <filename> "<download_url>"`) or give it to the user to click. Small files are additionally returned inline: images up to 3.75 MB as an image you can see, and any other file up to 256 KB as an embedded resource with its bytes. To only look at a file, its thumbnail is cheaper.

stream-file

Find files whose content is identical (matched by hash). Use when the user asks about "duplicate photos", "the same image uploaded twice", "storage cleanup", or "which files can I remove". Omit file_id to list every duplicate group in the DAM; pass a file_id to get the duplicates of that specific file.

find-file-duplicates

Retrieve CDN usage statistics — bandwidth, request counts, and top assets served via the public CDN. Use when the user asks about "CDN bandwidth", "our most-viewed public images", "embed traffic", or campaign reach via public links.

get-cdn-statistics

Retrieve embed settings and HTML code for embedding a CDN video with customizable player options.

get-cdn-video-embed-settings

Fetch one PIM category item: its display name (the value of its variation level's representative element), updated_at and every element value keyed by property_safe_name, plus optional related records.

get-category-item

Fetch the full structure of a PIM category — the ordered list of elements (fields), their types, option sets, and variation configuration. Use before creating/updating items so you know which attributes are valid, required, or variation-specific.

get-category-structure

Fetch a single channel item by ID — the channel-specific attribute values for a published product. Use when the user asks about a specific product on a specific channel ("show me how this product looks in the French webshop"), or before updating/deleting its channel presence.

get-channel-item

Retrieve download statistics — which files have been downloaded, by whom, when, via which template. Use when the user asks "what are our most-downloaded assets", "did anyone grab that campaign photo", "download activity by department", or for usage reporting.

get-download-statistics

Fetch one file by ID with its metadata (name, size, dimensions, folder, timestamps, archive and duplicate state) and any requested related records: albums, tags, custom fields, CDN, video CDN, focal point, faces.

get-file

Fetch CDN video details for a file — transcoding status, available renditions, streaming URL, and allow_download flag. Use when checking whether a video is ready to stream/embed, or as a lookup before updating its settings. Does not return the HTML embed snippet or player options.

get-file-cdn-video

Report a file's AI provenance for its current version: the AI-generated and AI-manipulated flags, whether they come from an embedded C2PA manifest (read-only) or were set by hand, the claim generator and when the manifest was made. Null when the file has no recorded provenance.

get-file-provenance

Fetch one subtitle track of a file: its language, label, source (manual, import or ai) and whether it is the default track. The cues are not included; they are read page by page from the track's cue listing.

get-file-subtitle