Marketplace
Package marketplace is the shop for tools and agents: browse, install into your project, publish your own free or priced.
Package marketplace is the shop for tools and agents: browse, install into your project, publish your own free or priced.
| Base URL | https://api.hanzo.ai |
| Operations | 6 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
marketplace
Install activates one tool for the caller's own org and project.
POST /v1/marketplace/install
Install activates one tool for the caller's own org and project. A marketplace install IS the tool plane's activation write — one store, one truth — so an installed capability is immediately dispatchable and a monetized one is priced from its listing at every call. The tool must resolve in the caller's scope, so installing something that does not exist is refused rather than recorded.
Request body — application/json (required)
| Field | Type | Required | Description |
|---|---|---|---|
tool | string | — | Tool is the registry name of the capability to activate (or deactivate) for the caller's own org and project. |
Unpublish withdraws one of the caller org's listings from the marketplace and answers 204.
DELETE /v1/marketplace/listings/{id}
Unpublish withdraws one of the caller org's listings from the marketplace and answers 204. Only the publishing org can remove its own listing; an id that is unknown, or belongs to another org, is the same 404, so a probe learns nothing about what exists. Removing a listing removes its price from per-call enforcement; it does not uninstall the tool for anyone who already installed it.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | ID is the listing to unpublish, from the path. |
ListListings returns the listings the caller's own org has published — what this org is offering, not what it can buy.
GET /v1/marketplace/listings
ListListings returns the listings the caller's own org has published — what this org is offering, not what it can buy. A publisher only ever sees its own rows.
Publish offers one tool on the marketplace, optionally monetized.
POST /v1/marketplace/listings
Publish offers one tool on the marketplace, optionally monetized. The tool must already resolve in the publisher's own scope, so a listing can never advertise a capability that does not exist; a listing with a price must name the payout wallet the x402 seam settles to, so a monetized offer is never unpayable. The price is exact to 18 decimal places, so a per-call price below a cent is a real price and not a rounded-away zero. The listing is owned by the publishing org, paid into a wallet of that same org, and answers 201 with the created row.
Request body — application/json (required)
| Field | Type | Required | Description |
|---|---|---|---|
category | string | — | Category groups the listing in the shop window. |
currency | string | — | Currency denominates Price. |
description | string | — | Description is the long copy, clipped at 4096 characters. |
price | string | — | Price is the per-call price as a decimal USD string, exact to 18 places — "0.0025" is a quarter of a cent and stays one. |
public | boolean | — | Public makes the listing discoverable by other orgs. |
recipient | string | — | Recipient is the seller's payout wallet ID, in the publishing org — the wallet x402 pays. |
title | string | — | Title is the shop-window name, 1-200 characters. |
tool | string | — | Tool is the registry name of the capability being offered. |
Uninstall deactivates one tool for the caller's own org and project, so it stops being dispatchable there.
POST /v1/marketplace/uninstall
Uninstall deactivates one tool for the caller's own org and project, so it stops being dispatchable there. It is the exact inverse of install and touches the same activation record; deactivating something that was never active is not an error. The listing itself is untouched — this withdraws the caller's use of a capability, not anyone's offer of it.
Request body — application/json (required)
| Field | Type | Required | Description |
|---|---|---|---|
tool | string | — | Tool is the registry name of the capability to activate (or deactivate) for the caller's own org and project. |
Discover lists every tool and agent the caller can reach in their own org and project, enriched with any public listing's title, category and price, and with installed=true on the ones already activated for that scope.
GET /v1/marketplace
Discover lists every tool and agent the caller can reach in their own org and project, enriched with any public listing's title, category and price, and with installed=true on the ones already activated for that scope. It is the shop window: one read that answers what exists, what it costs and what is already on.
How is this guide?