Step 2 Initialise upload

Initialise upload

Initialise an upload.

post/api/upload/init

Request

  • Base URL
    https://your-bynder-domain
  • URL
    https://your-bynder-domain/api/upload/init
  • Auth
    • OAuth 2
      Authorization code: https://your-bynder-domainDefaultValue/
      Client credentials
      Token URL: https://your-bynder-domainDefaultValue/token scopes: MEDIAUPLOAD, MEDIAUPLOADFORAPPROVAL
    • or API key in header Authorization

Headers

Content-Type'application/x-www-form-urlencoded' required

Request body application/x-www-form-urlencoded

filenamestring

Example request

{
  "filename": "image.jpeg"
}

Response

Successful response

s3_filenamestring
target_keystring

Example response

{
  "multipart_params": {
    "Content-Type": "image/*",
    "Policy": "AWS_S3_POLICY",
    "X-Amz-Signature": "AWS_S3_SIGNATURE",
    "acl": "private",
    "key": "pluploads/api/00000000-0000-0000-0000000000000000/image.jpeg",
    "success_action_status": "201",
    "x-amz-algorithm": "AWS4-HMAC-SHA256",
    "x-amz-credential": "AWS_S3_AUTH",
    "x-amz-date": "20160216T100755Z"
  },
  "s3_filename": "pluploads/api/00000000-0000-0000-0000000000000000/image.jpeg",
  "s3file": {
    "targetid": "final/00000000-0000-0000-0000000000000000/image.jpeg",
    "uploadid": "UPLOAD_ID"
  },
  "target_key": "pluploads/api/00000000-0000-0000-0000000000000000/image.jpeg"
}

Changes

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