§ Docs · API reference

API reference

Every public gateway route. Auth is one of none, session (Bearer token from SIWE login), or admin (operator-only dev endpoints gated by PLUMB_DEV_ADMIN_TOKEN). Machine-readable: openapi.json.

A.01

Auth

auth · 3 endpoints

Method	Path	Auth	Summary
GET	`/auth/siwe-nonce`	none	Issue a nonce for the SIWE message.
POST	`/auth/siwe-login`	none	Exchange a signed SIWE message for a Bearer session token.
GET	`/me`	session	Return the caller address and credit balance.

A.02

Chat / receipts

chat / receipts · 3 endpoints

Method	Path	Auth	Summary
POST	`/v1/chat/completions`	session	OpenAI-compatible chat. Returns completion + signed receipt.
GET	`/v1/receipts/:id`	session	One receipt, caller-scoped.
GET	`/v1/receipts`	session	Caller-scoped receipt list, reverse chronological.

A.03

Billing

billing · 2 endpoints

Method	Path	Auth	Summary
POST	`/admin/mint`	admin	Credit an address with micro-PLMB (dev + preview).
GET	`/v1/deposits`	session	Caller-scoped on-chain deposits.

A.04

Hub

hub · 3 endpoints

Method	Path	Auth	Summary
POST	`/hub/upload`	session	Raw binary upload. Content-addressed keccak256.
GET	`/hub/models/:hash`	session	Model metadata.
POST	`/hub/models/:hash/register`	admin	Register the model tuple on HubRegistry.

A.05

MemSync

memsync · 3 endpoints

Method	Path	Auth	Summary
GET	`/memsync/memories`	session	Caller memories.
DELETE	`/memsync/memories/:id`	session	Hard-delete one memory.
GET	`/memsync/profile`	session	Composed profile JSON.

A.06

Pipe

pipe · 4 endpoints

Method	Path	Auth	Summary
POST	`/pipe/inputs`	session	Upload input bytes for a future oracle request.
GET	`/pipe/inputs/:inputHash`	none	Public byte retrieval by hash (worker uses this).
GET	`/pipe/jobs`	session	Caller-scoped pipe jobs.
GET	`/pipe/jobs/:id`	session	One pipe job.

↳ For client code, see the Python SDK reference.