Search
K
Upload Assets

Upload Assets API

1.0.0OAS 3.1
API Base URL
  • Server 1:https://{your-bynder-domain}/
    Variables
    your-bynder-domain:
  • Server 2:https://your-bynder-domainDefaultValue
  • Server 3:https://DefaultParameterValue
  • Server 4:https://your-bynder-domainDefaultValue
  • Server 5:https://your-bynder-domainDefaultValue/v6/authentication/oauth2
  • Server 6:https://your-bynder-domainDefaultValue
  • Server 7:https://{your-auth-url}
    Variables
    your-auth-url:
  • Server 8:https://your-bynder-domainDefaultValue
  • Server 9:https://DefaultParameterValue
  • Server 10:https://your-bynder-domainDefaultValue
  • Server 11:https://your-bynder-domainDefaultValue/v6/authentication/oauth2
  • Server 12:https://your-bynder-domainDefaultValue
  • Server 13:https://bynder-public-us-east-1.s3.amazonaws.com/
Security
OAuth2 (oauth2)

Authorization Code OAuth Flow

Authorize URL: https://your-bynder-domainDefaultValue/

Token URL: https://your-bynder-domainDefaultValue/token

Scopes:

  • MEDIAUPLOAD -
  • MEDIAUPLOADFORAPPROVAL -

Client Credentials OAuth Flow

Token URL: https://your-bynder-domainDefaultValue/token

Scopes:

  • MEDIAUPLOAD -
  • MEDIAUPLOADFORAPPROVAL -
permanentToken (apiKey)

An API key is a token that you provide when making API calls. Include the token in a header parameter called Authorization.

Example: Authorization: 123

Step 1 Get closest AmazonS3 upload endpoint

This endpoint gets the AmazonS3 endpoint that is closest to your current location.

Get closest Amazon S3 upload endpoint

Get the closest AmazonS3 upload endpoint.

get

Response

200 application/json

Successful response

string
get/api/upload/endpoint
 
200 application/json

Step 2 Initialise upload

This endpoint prepares the upload of a file in chunks. It returns a file ID that will be used in subsequent steps to upload the file chunks and finalize the upload.

Initialise upload

Initialise an upload.

post

Headers

Content-Typestringrequired

Body

application/x-www-form-urlencoded
filenamestring

Example:image.jpeg

Response

application/json

Successful response

ApiUploadInitResponse

multipart_paramsobject
Show Child Parameters
s3_filenamestring

Example:pluploads/api/00000000-0000-0000-0000-000000000000/image.jpeg

s3fileobject
Show Child Parameters
target_keystring

Example:pluploads/api/00000000-0000-0000-0000-000000000000/image.jpeg

post/api/upload/init

Body

{}
 
application/json