Create Blob

Create a new blob within an organization.

POST `/orgs/:id/blobs`

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The unique ID or alias of the organization.

Request Body

Parameter	Type	Required	Description
`alias`	string	Yes	Unique alias for the blob within the org. 6–42 characters of `a`–`z`, `0`–`9`, `_` and `-`, and may not be shaped like a UUID.
`visibility`	string	Yes	`public` or `private`.
`type`	string	Yes	Dotted string naming the blob type. See the table below.

All three are required and nothing else is accepted. There is no name field: the blob is named after its alias, which is fixed at creation — Update Blob has no alias parameter, so a blob cannot be renamed once created. type is a single dotted string, not a composite of independent fields. Five are recognized, and an organization must additionally be permitted to create the one it names:

`type`	Blob type
`blobhub.compute.workflow`	Workflow
`blobhub.compute.scheduler`	Scheduler
`blobhub.model.onnx`	ONNX
`blobhub.graph.orientdb`	Graph
`blobhub.dataset.nlp`	NLP Dataset

Any other string — and any of these the organization is not permitted — is refused with invalid_blob_type.

Response

Parameter	Type	Description
`blob_id`	string	The unique ID of the blob.

The blob record exists the moment this call answers, but the rest of the creation is asynchronous: its status is creating_blob until the platform has provisioned it and its first revision, and only a ready blob accepts writes. Poll Get Blob for status and latest_revision_id.

Errors

Status	Error	Cause
400	`invalid_request_body`	A missing or malformed field, an alias outside the grammar, or an extra field.
403	`forbidden`	Missing `admin` access to the organization.
400	`invalid_blob_type`	The `type` value is not one this organization can create.
400	`limit_exceeded`	The organization already holds the maximum number of blobs.
400	`alias_in_use`	The blob alias must be unique within the organization.

Example

curl -X POST https://api.blobhub.io/v1/orgs/acme-corp/blobs \
  -H "X-API-Key: $ORG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alias": "alpha-fold-v2",
    "visibility": "public",
    "type": "blobhub.model.onnx"
  }'

{
  "status": "success",
  "blob_id": "blob_789"
}

REST API

WebSocket API

POST `/orgs/:id/blobs`

Path Parameters

Request Body

Response

Errors

Example

​POST /orgs/:id/blobs

​Path Parameters

​Request Body

​Response

​Errors

​Example

POST `/orgs/:id/blobs`

Path Parameters

Request Body

Response

Errors

Example