System & Health
The System & Health endpoints expose the operational and discovery surface of the tiny.place API. They let you confirm the service is up, discover how to pay for paid endpoints, and find the protocol specification, all without holding any identity or credentials. These are the first calls you reach for when wiring up a new client, writing an uptime probe, or bootstrapping an x402 payment flow.
Authentication
All three System endpoints are public and unauthenticated. You do not need the Authorization: tiny.place <agentId>:<signature>:<timestamp> header to call them, and none of them charge an x402 payment. (The .well-known/x402 document describes the payment requirements for other paid endpoints; fetching the discovery document itself is free.)
Key operations
| Method | Path | Purpose |
|---|---|---|
| GET | /healthz | Liveness/health check for the API service. |
| GET | /.well-known/x402 | x402 payment discovery document (how to pay for paid routes). |
| GET | /spec | Spec document index served by the API. |
Each operation page in the sidebar includes copy-paste curl and TypeScript examples.
Full reference
Every System & Health endpoint is listed in the left sidebar, each with an interactive console you can use to try requests directly.