BeginMultipartUpload

Begins a new multipart file upload process.

1curl "https://api.bytescale.com/v2/accounts/{accountId}/uploads" \
2     -H "Authorization: Bearer YOUR_API_KEY" \
3     -H "Content-Type: application/json" \
4     -d @- << EOF
5     {
6       "metadata": {
7         "myCustomField1": true,
8         "myCustomField2": {
9           "hello": "world"
10         },
11         "anotherCustomField": 42
12       },
13       "mime": "text/plain",
14       "originalFileName": "example.txt",
15       "path": {
16         "fileName": "example-{UNIQUE_DIGITS_4}{ORIGINAL_FILE_EXT}",
17         "folderPath": "/uploads"
18       },
19       "protocol": "1.1",
20       "size": 43182,
21       "tags": [
22         "example_tag"
23       ]
24     }
25EOF

1{
2  "file": {
3    "accountId": "YOUR_ACCOUNT_ID",
4    "etag": "33a64df551425fcc55e4d42a148795d9f25f89d4",
5    "filePath": "/uploads/image.jpg",
6    "fileUrl": "https://upcdn.io/A623uY2/raw/uploads/image.jpg",
7    "lastModified": 1615680311115,
8    "metadata": {
9      "myCustomField1": true,
10      "myCustomField2": {
11        "hello": "world"
12      },
13      "anotherCustomField": 42
14    },
15    "mime": "image/jpeg",
16    "originalFileName": "example.jpg",
17    "size": 43182,
18    "tags": [
19      "example_tag"
20    ]
21  },
22  "uploadId": "Kd759aLFxttm69kZ",
23  "uploadParts": {
24    "count": 12,
25    "first": {
26      "range": {
27        "inclusiveEnd": 5242879,
28        "inclusiveStart": 0
29      },
30      "uploadId": "Kd759aLFxttm69kZ",
31      "uploadPartIndex": 7,
32      "uploadUrl": "https://...long-url...x-id=PutObject"
33    }
34  }
35}

Request Body

See full details

Response Body

See full details

URL Path Parameters

accountId Required

Your account ID.

This is visible on the settings page:

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

Example: "A623uY2"

Type: String

Length: 7

Request Headers

Authorization Required

Add one of these Authorization header values to your request:

•Option 1: prefix "Bearer " to your API key. The result is your Authorization header value.

•Option 2: use HTTP basic authorization with apikey as your username and your API key as your password.

For advanced options, please see:

https://www.bytescale.com/docs/auth

Type: String

Content-Type Required

This endpoints requires a JSON request body.

Type: String

Value: "application/json"

Was this section helpful? Yes No

You are using an outdated browser.

This website requires a modern web browser -- the latest versions of these browsers are supported:

UI Widgets

SDKs

Processing APIs

Core APIs

Data Types

More Resources

BeginMultipartUpload

Request Body

Response Body

URL Path Parameters

accountId Required

Request Headers

Authorization Required

Content-Type Required

You are using an outdated browser.