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 can create one only while that type’s enabled entitlement is true for it. workflow.enabled, scheduler.enabled and onnx.enabled are true by default; orientdb.enabled and nlp.enabled are false — see Limits:

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 whose enabled entitlement is false for the organization, is refused with invalid_blob_type. For a recognized type the body also carries limit, naming the entitlement: {"id": "orientdb.enabled", "value": false}.

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 default_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 recognized, or its enabled entitlement is false for this organization. For a recognized type the body carries limit.
400	limit_exceeded	The organization already holds as many blobs as platform.blobs_per_org allows, a blob whose creation failed included. See When a limit is reached.
400	alias_in_use	The blob alias must be unique within the organization.

Example

Request

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"
  }'