Blob

What the CRDT references, and what the catalog records.

The bytes are never in Loro; this is.

Type object

Shape

Field	Type	Description
hashrequired	BlobHash	`<algorithm>:<digest>` - `b3:<64 hex>`. The algorithm is in the value because a hash that does not say what it is cannot be migrated: adopting a second one has to be additive, or every document already written is orphaned.
sizerequired	integer (uint64, >= 0)
mimerequired	string
filename	string or null	The name the person's file had. Metadata only - arbitrary Unicode, never identity, never a path component, never emitted into a header unencoded.
created_atrequired	Timestamp	Epoch milliseconds, UTC. Signed, so instants before 1970 are representable.
attributes	map of string to BlobAttribute	Typed extra facts, keyed by a `blob_attr` constant. Additive on the wire and in storage: absent reads as empty, and an unknown key is kept but ignored.

Example

{
  "hash": "string",
  "size": 0,
  "mime": "string",
  "filename": "string",
  "created_at": 0,
  "attributes": {
    "key": {
      "type": "int",
      "value": 0
    }
  }
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

GET/v1/workspaces/{id}/blobs
Every blob this workspace holds
PUT/v1/workspaces/{id}/blobs
Store bytes and get back the address they are filed under
POST/v1/workspaces/{id}/blobs/{hash}
Associate another workspace of the same Profile with one blob

Generated from contract version 1. Last updated November 12, 2026.