Create Asset Upload

Header Parameters

X-Client-App?string|null

Authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

content_md5?|

Base64-encoded MD5 of the exact upload bytes. When supplied it is signed into the OSS PUT request so OSS rejects corrupted content before completion.

feature_code?|

Product feature that initiated the upload. Optional for backward compatibility; new clients should provide it so rejected uploads remain attributable.

file_name*File Name

Length1 <= length <= 191

media_type*Media Type

Value in

"image/jpeg"
"image/png"
"image/webp"

sha256?|null

size_bytes*Size Bytes

Range1 <= value

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/assets/uploads" \  -H "Content-Type: application/json" \  -d '{    "file_name": "string",    "media_type": "image/jpeg",    "size_bytes": 1  }'

{  "asset_id": "string",  "object_key": "string",  "source": {    "asset_id": "string",    "media_type": "image/jpeg",    "sha256": "string",    "url": "string"  },  "upload": {    "expires_at": "2019-08-24T14:15:22Z",    "headers": {      "property1": "string",      "property2": "string"    },    "method": "string",    "url": "string"  }}

Header Parameters

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`