get_resource | Get the details of one asset by public ID (size, format, URLs, tags, context, derived assets). Arguments: public_id (string, required, may contain folder slashes such as “product/shoe”), resource_type (“image” | “video” | “raw”, optional, default “image”), type (delivery type, optional, default “upload”), colors / media_metadata / faces / pages / coordinates / related (booleans, optional: include those details), max_results (integer 1–100, optional: derived assets returned). |
get_usage | Get the account plan and current usage report: storage, bandwidth and transformation usage and limits, Admin API rate limits and other product environment usage data. No arguments. |
list_resources | List assets of one resource type and delivery type, newest first. Arguments: resource_type (“image” | “video” | “raw”, optional, default “image”; use “video” for audio too), type (delivery type, optional, default “upload”: “upload” | “private” | “authenticated” | “fetch” | …), prefix (string, optional: public IDs starting with it, then sorted by public ID), max_results (integer 1–500, optional, default 10), next_cursor (string, optional, from the previous page), start_at (ISO 8601 date, optional, not with prefix), direction (“asc” | “desc”, optional), tags / context / metadata (booleans, optional: include them per asset). |
list_root_folders | List the root folders (name, path and external_id of each, up to 2000). No arguments. |
list_subfolders | List the subfolders of a folder. Arguments: folder (string, required: full path of the parent folder, e.g. “product/shoe”), max_results (integer 1–500, optional, default 10), next_cursor (string, optional, from the previous page). |
list_tags | List the tag names used on assets of one resource type. Arguments: resource_type (“image” | “video” | “raw”, optional, default “image”), prefix (string, optional: tags starting with it), max_results (integer 1–500, optional, default 10), next_cursor (string, optional, from the previous page). |
list_transformations | List stored transformations. Arguments: named (boolean, optional: true = named transformations only, false = unnamed only, omitted = both), max_results (integer 1–500, optional, default 10), next_cursor (string, optional, from the previous page). |
list_upload_presets | List upload presets (name, signed or unsigned, settings such as tags, folder, allowed formats, eager transformations). Arguments: max_results (integer 1–500, optional, default 10), next_cursor (string, optional, from the previous page). |
search_resources | Search assets with a Lucene-like query expression (read-only query). Arguments, all optional: expression (string: field:value tokens combined with AND / OR / NOT or a leading ”-”, e.g. “resource_type:image AND tags=sale AND uploaded_at>1d”, “shirt AND -tags:blue”, “asset_folder=product/shoes” (that folder only), “asset_folder:product/*” (and its subfolders), “format=png AND bytes>100000”; ”=” is an exact match, ”:” a token match; without it the newest assets are listed), sort_by (array of one-key objects, e.g. [{“created_at”: “desc”}], values “asc” | “desc”), max_results (integer 1–500, default 10), next_cursor (string, from the previous page, with the same other arguments), fields (string, comma-separated fields to return), with_field (string: “context” or “tags”, extra attribute to include). |
