Blobs

Upload

PUT /v1/blobs
Authorization: Bearer ltx_your_key
Content-Type: application/pdf

<raw bytes>

Multipart (file field) or raw body. Returns content-addressed blob_id (b_ + 16 hex). Duplicate bytes → 200 idempotent. Enforces aggregate tier blob storage (413 BLOB_STORAGE_LIMIT).

Download

GET /v1/blobs/{blob_id}
Authorization: Bearer ltx_your_key

Supports HTTP Range. Wrong agent or soft-deleted → 404 BLOB_NOT_FOUND.

List

GET /v1/blobs?page=1&per_page=50
Authorization: Bearer ltx_your_key

Metadata

GET /v1/blobs/{blob_id}/meta
Authorization: Bearer ltx_your_key

Signed read URL

GET /v1/blobs/{blob_id}/signed-url?expires_in=3600
Authorization: Bearer ltx_your_key

Delete

DELETE /v1/blobs/{blob_id}
Authorization: Bearer ltx_your_key

204 when the request is valid: soft-deletes an active blob, or is an idempotent no-op if the blob is already gone for this agent (including never existed or another agent’s object — same 204 so existence is not leaked). Malformed blob_id (not b_ + 16 hex) → 404 BLOB_NOT_FOUND. When a row actually transitions to soft-deleted, aggregate blob_storage_bytes refreshes. Storage objects are removed later by reconciliation after a configurable grace period.

Billing

See Billing: blob_storage_bytes / blob_storage_limit_bytes for aggregate object storage (separate from memory embedding bytes).

MCP

Static tool schemas: GET https://lithtrix.ai/mcp/lithtrix-blob-upload.json (and -download, -list, -meta, -delete, -signed-url).

Getting Started

API Reference

Concepts

Integrations

Upload

Download

List

Metadata

Signed read URL

Delete

Billing

MCP

​Upload

​Download

​List

​Metadata

​Signed read URL

​Delete

​Billing

​MCP

Upload

Download

List

Metadata

Signed read URL

Delete

Billing

MCP