Request upload URLs for real-time upload

SecurityC2CDeviceAuth or C2COAuth2

Request

path Parameters

asset_id

required

string <uuid>

Asset ID

Example: 87817fee-e5b1-4aad-8165-2ee2bedd99cc

header Parameters

x-client-version

string

Default: 0.0.0

Firmware or software version of a C2C integration. Will be used to determine the correct Device Model configuration for the device when multiple are available. Must be a valid semantic version.

For more on semantic versions, see here: https://semver.org/

Example: 2.16.4

Request Body schema: application/json

Enumerates parts that upload URLs should be created for.

required	Array of objects List of file upload parts to register with Frame.
asset_name	string\..+ Default: null Updates the asset name if only `extension` was supplied to assetCreate, and the default name is still in use. Otherwise, will be ignored.
asset_filesize	integer [ 1 .. 5497558138880 ] Default: null The full filesize for the upload in bytes. This field is required when an object in `parts` has `is_final` set to `true`. Must be no more than 5 TiB.

Responses

200

Returns array of upload URLs for created parts.

Response Schema: application/json

upload_urls

required

Array of strings <uri> non-empty

Array of AWS S3 presigned upload PUT URLs.

Returned in the same order as the parts field of the request.

400

Bad Request

401

Unauthorized response

404

Not Found response

429

Standard frame.io API error response.

post/v2/devices/assets/{asset_id}/realtime_upload/parts

Request samples

application/json

{"parts": [{"number": 1,
"size": 2000000000,
"is_final": false
},
{"number": 2,
"size": 1500000000,
"is_final": false
}
]
}

Response samples

application/json

{"upload_urls": ["https://frameio-uploads-production.s3-accelerate.amazonaws.com/parts/[part_02_path]"
]
}