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
location full type
location full type
position full type
position full type
enrichmentItem full type
enrichmentItem full type
batchAddMediaItems
albums.batchAddMediaItems
Add up to 50 media items to an app-created album
Risk: write
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
Output: empty object
create
albums.create
Create an album with a title
Risk: write
Output
get
albums.get
Read one album this app created
Risk: read
Output
list
albums.list
List the albums this app created; since March 2025 the API reads nothing else
Risk: read
Only albums this app created are readable; the wide-read scope was removed in 2025.
Output
albums full type
albums full type
update
albums.update
Rename an app-created album (sends the title update mask)
Risk: write
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
Each requested id gets an entry, and a failed id carries a status instead of an item.
Output
mediaItemResults full type
mediaItemResults full type
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
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.
newMediaItems full type
newMediaItems full type
albumPosition full type
albumPosition full type
newMediaItemResults full type
newMediaItemResults full type
get
mediaItems.get
Read one media item this app created
Risk: read
Output
mediaMetadata full type
mediaMetadata full type
contributorInfo full type
contributorInfo full type
list
mediaItems.list
List the media items this app created, 25 per page by default
Risk: read
Output
mediaItems full type
mediaItems full type
search
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
Send
albumId or filters, never both; the API answers 400 for that combination.
filters full type
filters full type
mediaItems full type
mediaItems full type
update
mediaItems.update
Change an app-created media item’s description, the only editable field
Risk: write
Output
mediaMetadata full type
mediaMetadata full type
contributorInfo full type
contributorInfo full type