Media

Retrieve a media file

Changed on

Retrieves the metadata for a media file along with a fresh signed URL valid for fifteen minutes.

get/media/{id}

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/media/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The Cavuno media object's id returned by POST /v1/media/upload.

Response

Successful response.

idstring required

Unique identifier for the object. Use this value as the {id} path parameter for GET /v1/media/{id}.

object'media_upload' required

String representing the object's type. Objects of the same type share the same value.

urlstring nullable required

URL where the file can be downloaded. Permanent for files served from the assets domain; a signed URL for legacy files. Always set on the upload response; may be null on retrieval if the underlying blob has been deleted.

urlExpiresAtstring nullable required

Time at which the signed url expires (ISO 8601 datetime), or null when the url is permanent and never expires.

mimeTypestring required

MIME type of the uploaded file.

sizeBytesnumber required

Size of the uploaded file, in bytes.

purpose'board_logo' | 'board_hero' | 'account_avatar' | 'company_logo' | 'blog_image' required

Resource type the file was uploaded for.

uploadedAtstring required

Time at which the file was uploaded. ISO 8601 datetime.

Changes