---
title: "Resumable upload"
method: POST
path: "/resumable_upload_url"
tags: ["binary_upload"]
---

# Resumable upload

`POST /resumable_upload_url`

Users uploading larger files and/or with poor connectivity can initiate a
resumable upload session with the `resumable_upload_url` from the
`upload_request` body.

Google provides some great
<a href="https://cloud.google.com/storage/docs/performing-resumable-uploads" target="_blank">documentation</a>
on resumable uploads (as the content will be uploaded to Google Cloud
Storage).

> **NOTE:** Resumable Uploads use the POST method on initialization and the
PUT method after to resume upload.

> **NOTE:** After uploading a file, you can add it as Brandfolder asset by
copying the `object_url` value from the [Get an upload
URL](/api/brandfolder/openapi/binary_upload/opidstorageserviceuploadrequestsget)
response into your request body's `attachments.url` property. See [Create
assets in a
Brandfolder](/api/brandfolder/openapi/assets/opidapiv4collectionsassetsbybrandfolderidpost)
for details.

## Headers

- `x-goog-resumable` 'start', required

## Response `200`

Successful response.

- object

## Other responses

- `201` — Upload was interrupted. Resume uploading at this URL.
- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/revisions/fd95b0a2d2f8/schema)