BizKitHub
DocsAPI ReferenceBlob/bff/blob/upload
postBlobAdmin BFF

/bff/blob/upload

Uploads a file via multipart/form-data. The request body must contain a "file" field with the binary data, an optional "blobPath" for storage path prefix, and an optional "tag" for categorization. Returns a blob token for referencing the uploaded file.

BlobpostBffBlobUpload

Parameters

JSON body

Request body

application/json
filestringRequiredbinary

Binary file payload.

Default: File
blobPathstringOptional

Optional storage path prefix.

Examplepost/N195wg3F34tFierY
tagstringOptional

Optional categorization tag.

Examplepost
conflict"keepBoth" | "replace"Optional

Drive only: what to do when the folder already has a file with this name. Default 'keepBoth' ("Report (2).pdf"); 'replace' uploads a new version of the existing file (kept in its history) unless records use it.

Response schema

1 status code documented

200Success
blobTokenstringRequired

Token to reference the uploaded blob.

Exampleblb_abc123xyz
filenamestringOptional

Final display name (may carry a "(2)" counter).

replacednumberOptional

Drive replace: existing files that got a new version (blobToken = that file).

replaceBlockednumberOptional

Drive replace: old files kept because records use them.

Response example

application/json
{
  "blobToken": "blb_abc123xyz",
  "filename": "example_filename",
  "replaced": 0,
  "replaceBlocked": 0
}

Request example

POST /bff/blob/upload

post
curl -X POST "https://api.bizkithub.com/bff/blob/upload" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "file": "File",
  "blobPath": "post/N195wg3F34tFierY",
  "tag": "post"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key