Media

Upload, tag, organize, and moderate photos and other assets.

• Writefetch_gbp_mediaFetch a location's Google Business Profile photos (owner-uploaded + user-generated) via the Google My Business v4 media APIs, dedup by the GBP media id, and store them in the client media library, tagged so they're traceable back to that GBP media item. Requires the location to have Google connected (returns status 'not_connected' otherwise). Google-only.
• Writemoderate_pending_ugc_mediaClassify pending customer-submitted (UGC) photos in the media library as ok/needs_review/spam/skipped, using a business-context-aware vision prompt (client industry/description, mismatched-listing detection, platform-UI-chrome detection). Use this for requests like 'check for inappropriate photos customers uploaded', 'clean up the media library', or 'moderate new uploads' — it finds and flags anything spammy, unrelated, or inappropriate instead of waiting for the daily automatic sweep. Pass clientId to scope to one client; omit to sweep every client in this agency. Resumable: only touches rows that are unclassified or previously 'skipped' (retried after 24h).
• Readlist_flagged_mediaList customer-submitted (UGC) media library photos by moderation status — the read counterpart to moderate_pending_ugc_media. Use this to answer questions like 'what needs my attention', 'show me the spam photos', 'did any customer uploads look inappropriate', or 'what photos got flagged' by looking at the real current verdicts, instead of guessing. Returns id, mediaUrl, status, the classifier's one-line reason, createdAt, and the client/location it belongs to. Omit status to list every UGC photo regardless of verdict (including never-classified ones); omit clientId to search the whole agency.
• Writeupload_assetUpload a new file (e.g. a photo, image, PDF, or other file) into the agency's media library. Provide the file as a public https URL (fetched and stored — a URL pointing at a private/internal network address is rejected) or as base64 bytes. Max 100 MB. Optionally scope it to an account/client/location/brand, drop it straight into a folder, tag it, or associate it with locations. Returns the created asset (including its key, used by update_asset/delete_asset and folder/tag operations).
• Writeupdate_assetEdit a photo/image's (or other file's) tags, folder memberships, or location associations (any source — uploads, Sydekick-generated, or synced media), and, for uploads only, its title/scope. Each of tags/folderIds/locationIds you pass REPLACES the full current list for that field — pass the complete desired list, not just additions. locationIds replaces only the associations added here (the asset's `assignedLocationIds`); synced media and GBP-imported photos also carry a location stamped by the source itself, which shows in `locationIds` and cannot be removed from this side. NOTE: unlike editing an asset's locations in the app UI, assigning a location here does NOT push the image into that location's Google-publish queue — that bridge is UI-only. For synced/UGC media only, status sets the moderation verdict by hand (ok, needs_review, or spam) — the same thing the Flag/Mark OK actions in the app do; optionally pair it with statusReason. Identify the asset by its key (e.g. "upload:abc123", from upload_asset or the library listing).
• Writedelete_assetArchive an uploaded photo, image, or other file — this never permanently deletes it. The bytes, record, tags/folder memberships, and share links all stay in place; it just stops appearing anywhere in the library. Only uploads can be archived this way — Sydekick-generated or synced media assets are read-only here; remove them from folders or untag them instead. Identify the asset by its key (e.g. "upload:abc123").
• Writeai_edit_assetRegenerate a Sydekick-generated asset's image (or text) in place from a text prompt — the same "Edit with AI" action available in the Data tab. Generated assets only (uploads and synced media return an error). The first request after a period of inactivity can take a minute or more; later ones are faster. Identify the asset by its key (e.g. "generated:abc123"). Returns the refreshed asset at the same key.
• Readlist_asset_foldersList the agency's media-library folders (each can hold a mix of uploads, Sydekick-generated assets, and synced media). Optionally scope to an entity. Use this to find a folderId for update_asset, add_asset_to_folder, or remove_asset_from_folder.
• Writecreate_asset_folderCreate a new media-library folder. Optionally scope it to an account/client/location/brand.
• Writeupdate_asset_folderRename or re-scope an existing media-library folder. Pass only the fields you want to change. Identify it by its id (from list_asset_folders).
• Writedelete_asset_folderDelete a media-library folder. The assets that were in it are NOT deleted — they only lose their membership in this folder. Identify it by its id (from list_asset_folders).
• Writeadd_asset_to_folderAdd one or more assets to a folder. Idempotent — assets already in the folder are left as-is. Returns the folder's new total item count.
• Writeremove_asset_from_folderRemove one asset from a folder. The asset itself is untouched. Returns the folder's new item count.
• Readlist_asset_tagsList the agency's media-library tag vocabulary, each with its usage count. Use this before create_asset_tag/update_asset_tag/delete_asset_tag.
• Writecreate_asset_tagCreate a new media-library tag, or return the existing one if this exact name already exists (idempotent). Apply it to assets via update_asset's tags field.
• Writeupdate_asset_tagRename a tag — applies everywhere it's used. If another tag already has the new name, this MERGES into it instead (moves every assignment onto the existing tag and removes this one) rather than creating a duplicate name. Identify it by its id (from list_asset_tags).
• Writedelete_asset_tagPermanently delete a tag and remove it from every asset it was applied to. The assets themselves are untouched. Returns how many assets lost the tag. Identify it by its id (from list_asset_tags).