Share
Package share is a public URL for a service on your own machine, and a list of what you have open.
Package share is a public URL for a service on your own machine, and a list of what you have open.
| Base URL | https://api.hanzo.ai |
| Operations | 2 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
share
POST /v1/share/enable
Enable provisions the caller org's tunnel account and returns the credential the
hanzo share CLI needs to run a tunnel. It is idempotent: the account is keyed
deterministically off the VALIDATED org, so a repeat call hands back the same
account rather than creating a second one, and a caller can only ever provision
their OWN org's account. 503 when the deployment has no share controller
configured; 502 when that controller is unreachable.
GET /v1/share
Returns the tunnel shares the caller's org currently has open, across every environment that org has enabled. It is a READ and it degrades honestly: an unconfigured deployment, an org that has not provisioned yet, and an unreachable controller all answer an EMPTY list at 200 rather than an error, so the console never error-toasts on load.
How is this guide?