Media

Complete a staged media upload

Changed on

Verifies the staged object against the intent using storage-owned byte length and MIME metadata, processes it through the normal media pipeline, and returns the resulting media object.

post/media/upload-intents/{intentId}/complete

Request

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

Path parameters

intentIdstring required

Request body

stagingStorageIdstring required

The storageId returned after POSTing the raw file to the intent uploadUrl.

Response

Upload completed.

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.

Changes

  • c34152c38176Revision 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

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status