Skip to main content
POST
Bulk upload attachments
Requires a valid authenticated request for the builder. No resource-specific scope is required for upload. Uploads multiple attachment files into BuildPass-managed attachment storage and returns attachment references. Include type=attachment in the multipart body to apply the same type to all files, or type:0=attachment, type:1=attachment, and so on to set a type per file. The type tells BuildPass which storage family to use; attachment is the only externally supported upload type for now. For example, you can use each returned { key, regionId, type } to bulk upsert photos by passing it as photos[].imageAttachment.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

builderId
string
required

Body

multipart/form-data
type
enum<string>
required

Upload type to apply to every file.

Available options:
attachment
file:0
file
type:0
enum<string>

Optional upload type for file:0.

Available options:
attachment
file:1
file
type:1
enum<string>

Optional upload type for file:1.

Available options:
attachment

Response

201 - application/json

Attachments uploaded

uploads
object[]