Skip to main content
New to Corsair? See API access, authentication, and error handling.

Albums

addEnrichment

albums.addEnrichment Add a text note or a location to an app-created album, at a chosen position Risk: write
Input
Output

batchAddMediaItems

albums.batchAddMediaItems Add up to 50 media items to an app-created album Risk: write
Input Output: empty object

batchRemoveMediaItems

albums.batchRemoveMediaItems Remove up to 50 media items from an album. The items stay in the library, so this is reversible by adding them back Risk: destructive
Input Output: empty object

create

albums.create Create an album with a title Risk: write
Input Output

get

albums.get Read one album this app created Risk: read
Input Output

list

albums.list List the albums this app created; since March 2025 the API reads nothing else Risk: read
Input Only albums this app created are readable; the wide-read scope was removed in 2025. Output

update

albums.update Rename an app-created album (sends the title update mask) Risk: write
Input Sends PATCH with the title mask. The API also accepts coverPhotoMediaItemId, which this plugin does not expose yet. Output

Media Items

batchGet

mediaItems.batchGet Read up to 50 app-created media items by id, with a per-id status Risk: read
Input Each requested id gets an entry, and a failed id carries a status instead of an item. Output

create

mediaItems.create Upload bytes and create up to 50 media items, optionally in an album; uploads count toward the user’s Google storage past 25MB Risk: write
Input Each file is a public URL or base64 (up to 200 MB). The endpoint uploads them, then creates up to 50 items from the returned tokens; a failed item carries a status code.
Output

get

mediaItems.get Read one media item this app created Risk: read
Input Output

list

mediaItems.list List the media items this app created, 25 per page by default Risk: read
Input Output

mediaItems.search Search the media items this app created with date, content, feature and media-type filters, or list one app-created album Risk: read
Input Send albumId or filters, never both; the API answers 400 for that combination.
Output

update

mediaItems.update Change an app-created media item’s description, the only editable field Risk: write
Input Output