Skip to main content
POST
/
builders
/
{builderId}
/
attachments
/
bulk-upload
Bulk upload attachments
curl --request POST \
  --url https://api.buildpass.global/builders/{builderId}/attachments/bulk-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form type=attachment \
  --form file:0='@example-file' \
  --form type:0=attachment \
  --form file:1='@example-file' \
  --form type:1=attachment
{
  "uploads": [
    {
      "key": "external-uploads/ckbuilder123456789012345678/photo.jpg",
      "type": "attachment",
      "regionId": "au1",
      "imageUrl": "<string>",
      "fileName": "<string>",
      "contentType": "<string>",
      "fieldName": "<string>"
    }
  ]
}
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[]