# Brandfolder Binary Upload API

**Canonical:** https://apis.io/apis/brandfolder/brandfolder-binary-upload-api/  
**Provider:** Brandfolder — https://apis.io/providers/brandfolder/  
**Base URL:** https://brandfolder.com/api/v4  
**Documentation:** https://developers.smartsheet.com/api/brandfolder

Brandfolder Binary Upload API is one of 13 APIs that [Brandfolder](https://apis.io/providers/brandfolder/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Brandfolder's Binary Upload service allows for authenticated users to upload locally stored files into Brandfolder via our API. Binary Upload is a multi-step process: 1. [Get an upload URL](/api/brandfolder/openapi/binary_upload/opidstorageserviceuploadrequestsget) 2. Upload the file to the storage bucket using one of the methods below : - [Upload a file](/api/brandfolder/openapi/binary_upload/opidstorageservicebfuploadrequestbucketput) - [Resumable upload](/api/brandfolder/openapi/binary_upload/opidstorageservicebfuploadrequestpost) 3. [Create an asset](/api/brandfolder/openapi/assets/opidapiv4collectionsassetsbybrandfolderidpost), telling the Brandfolder API the attachment is at that URL. The Brandfolder Upload Request endpoint will return a response body with a signed `upload_url`, `resumable_upload_url`, storage `service_type` and `object_url`. Each Binary Upload `request_url` and `object_url` are designed to be used one time for a singular Asset. Both the `upload_url` and `resumable_upload_url` will expire 24 hours after they're issued. Assets uploaded to the `object_url` will be stored for 7 days before being purged. Should any of these URLs expire, you will simply need to restart the workflow to obtain active URLs. > **Tip:** We recommend that you use the Resumable Upload flow if you have poor internet connection, you're uploading local files that are larger than 200MB or if you're uploading files from a server that are larger than 500MB. ![Upload Request Flow](../images/bf-upload-request-interactions.png)

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/upload_requests` | Get an upload URL |
| PUT | `/upload_url` | Upload a file |
| POST | `/resumable_upload_url` | Resumable upload |
| PUT | `/resumable_upload_url` | Resume upload |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/openapi/brandfolder-binary-upload-api-openapi.yml
- **Documentation** — https://developers.smartsheet.com/api/brandfolder
- **APIReference** — https://developers.smartsheet.com/api/brandfolder/openapi
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/asyncapi/brandfolder-webhooks.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/mcp/brandfolder-tool-crosswalk.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/errors/brandfolder-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/data-model/brandfolder-data-model.yml

## Other Brandfolder APIs (12)

- [Brandfolder Assets API](https://apis.io/apis/brandfolder/brandfolder-assets-api/)
- [Brandfolder Attachments API](https://apis.io/apis/brandfolder/brandfolder-attachments-api/)
- [Brandfolder Brandfolders API](https://apis.io/apis/brandfolder/brandfolder-brandfolders-api/)
- [Brandfolder Collections API](https://apis.io/apis/brandfolder/brandfolder-collections-api/)
- [Brandfolder Custom Fields API](https://apis.io/apis/brandfolder/brandfolder-custom-fields-api/)
- [Brandfolder Invitations API](https://apis.io/apis/brandfolder/brandfolder-invitations-api/)
- [Brandfolder Labels API](https://apis.io/apis/brandfolder/brandfolder-labels-api/)
- [Brandfolder Organizations API](https://apis.io/apis/brandfolder/brandfolder-organizations-api/)
- [Brandfolder Sections API](https://apis.io/apis/brandfolder/brandfolder-sections-api/)
- [Brandfolder Tags API](https://apis.io/apis/brandfolder/brandfolder-tags-api/)
- [Brandfolder User Permissions API](https://apis.io/apis/brandfolder/brandfolder-user-permissions-api/)
- [Brandfolder Webhooks API](https://apis.io/apis/brandfolder/brandfolder-webhooks-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brandfolder/brandfolder-binary-upload-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brandfolder/.