Skip to main content
POST
Upload a Batch of Objects
Deprecated on Speckle Cloud and Speckle Enterprise Server 2026.9 and later, where it writes object graphs only. On Speckle Cloud, publish through ingestions instead. Current on the open-source Speckle Server.

Notes

  • The server accepts multiple batches as multiple files in the same call
  • It’s recommended to compress the batch with gzip and set the uploaded file content_type to application/gzip
  • Otherwise, set it to application/json

Limits

  • Maximum size of each individual object: 10 MB (large objects can be split into multiple objects using chunkable properties and detachable properties)
  • Maximum size of each request: 50 MB hard limit

Authorizations

Authorization
string
header
required

Personal access token. Get your token from your Speckle profile settings.

Path Parameters

projectId
string
required

The ID of the project

Body

file
file

JSON file containing an array of objects, optionally gzip-compressed

Response

Objects uploaded successfully