BYbytescale
Upload

Upload from a URL with a single HTTP request:

Changed on

Upload from a URL with a single HTTP request:

post/v2/accounts/{accountId}/uploads/url

Request

Path parameters

accountIdstring required

Your account ID.

This is visible on the settings page:

https://www.bytescale.com/dashboard/settings

Example:A623uY2

Request body

metadataFileMetadata

The file metadata specified in the original upload request as a JSON object.

mimestring

File MIME type.

originalFileNamestring

The file's original name on the user's device.

tagsFileTagName[]

The file tags to store against the file.

When you associate file tags with a file, Bytescale checks which rules match the tags (if any) and applies those rules to the upload request:

Rules can include max file size checks, traffic limit checks, rate limit checks, and so forth. These are configured in the Bytescale Dashboard.

timeoutinteger

The maximum time (in milliseconds) the entire operation is allowed to run before being aborted.

The default value is 30000 (30 seconds).

urlstring required

Source URL to upload.

Example request

{
  "url": "https://assets.bytescale.com/example.jpg"
}

Response

Success.

accountIdstring required

Your account ID.

This is visible on the settings page:

https://www.bytescale.com/dashboard/settings

etagstring required

The file's ETag, short for "entity tag", reflects the file's version and changes whenever the file is modified.

filePathstring required

Absolute path to a file. Begins with a /.

fileUrlstring required

URL for a raw file hosted on the Bytescale CDN.

Example response

{
  "accountId": "A623uY2",
  "etag": "33a64df551425fcc55e4d42a148795d9f25f89d4",
  "filePath": "/uploads/file.txt",
  "fileUrl": "https://upcdn.io/A623uY2/raw/uploads/file.txt"
}

Changes

  • d63ecdd9ae9cRevision changes
    • warning

      changed the pattern of the request property from ^[a-z0-9]+/[a-z0-9+\-._]+(?:;[^=]+=[^;]+)*$ to ^[a-zA-Z0-9]+/[a-zA-Z0-9+\-._]+(?:;[^=]+=[^;]+)*$

    • info

      added the new optional request property

    • info

      the request property's maxLength was increased from 1024 to 8192

    • info

      added the required property to the response with the status