node-media

Upload node media

Returns a URL to upload media for a node.

post/forms/{formId}/nodes/{nodeId}/media

Request

  • Base URL: https://api.clipform.io/v1
  • URL: https://api.clipform.io/v1/forms/{formId}/nodes/{nodeId}/media
  • Auth: HTTP bearer

Path parameters

formIdstring uuid required
nodeIdstring uuid required

Request body

media_type'video' | 'still' required

Type of media - video (plays) or still (static image/color, optional audio)

media_source'uploaded' | 'recorded'

How the media was created

durationnumber

Media length in seconds (optional).

fit_mediaboolean

true = contain (show the whole frame), false/omitted = cover (fill the player, croppable, positionable)

Response

Upload URL created

media_idstring uuid
upload_urlstring uri

The URL to upload the file to.

upload_method'tus' | 'put'

How to send the file: "tus" = resumable upload (the tus.io protocol, used for video), "put" = a single PUT request (used for images).

status'awaiting_upload'

Changes

No recorded changes to this operation across all 1 revision of this API.