Media Gallery

Favorite Media Asset

Mark a gallery asset as a favorite (idempotent one-tap toggle).

Returns the updated asset. Surface favorites via the list endpoint's ?favorites_only=true filter.

Required Scopes: media_gallery:update

post/api/v1/media-gallery/{asset_id}/favorite

Request

  • Base URL: https://api.sendseven.com
  • URL: https://api.sendseven.com/api/v1/media-gallery/{asset_id}/favorite
  • Auth: HTTP bearer

Path parameters

asset_idstring required

Response

Successful Response

idstring required

Gallery asset id (media_assets.id)

attachment_idstring required

Durable reference to the stored attachment (attachments.id)

urlstring required

Fresh, usable download/preview URL for the attachment. May expire — persist attachment_id, not this.

thumbnail_urlstring nullable

Fresh, ready-to-render thumbnail URL (small image/video poster). Generated asynchronously after upload and on lazy view; null while generation is pending or for documents. May expire — do not persist.

display_namestring required

Human-friendly asset name

descriptionstring nullable

Optional longer description

media_typestring required

image | video | document

content_typestring required

MIME type of the underlying attachment

file_sizeinteger nullable

Size in bytes (may be null)

tagsstring[]

Normalized lowercase tags

is_favoriteboolean

Whether the asset is marked as a favorite by the tenant

created_atstring date-time required

When the asset was saved to the gallery

last_used_atstring date-time nullable

Last outbound reuse; null if never reused

Changes

No recorded changes to this operation across all 3 revisions of this API.