Media

Create a staged media upload intent

Changed on

Creates a short-lived direct-upload intent for media bytes that cannot travel through a JSON or code argument. POST the original file bytes to the returned uploadUrl, then complete the intent with the returned storageId.

post/media/upload-intents

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/media/upload-intents
  • Auth: HTTP bearer

Request body

filenamestring required
mimeTypestring required
sizeBytesinteger required
purpose'board_logo' | 'board_hero' | 'account_avatar' | 'company_logo' | 'blog_image' required
resourceTypestring
resourceIdstring

Response

Upload intent created.

idstring required

Opaque staged media upload intent identifier.

object'media_upload_intent' required
uploadUrlstring uri required

Short-lived URL that accepts the original raw file bytes.

expiresAtstring date-time required

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status