{"name":"mintbot Public API","version":"1","description":"Self-service REST API for spinning up personal AI agents on dedicated VPS hosts.","endpoints":[{"method":"GET","path":"/v1/plans","auth":false,"desc":"List all setup tiers + bundled agent credit"},{"method":"GET","path":"/v1/models","auth":false,"desc":"List supported LLM models + per-MTok prices"},{"method":"GET","path":"/v1/prices","auth":false,"desc":"Live BTC + XMR USD prices"},{"method":"GET","path":"/v1/agent-fleet-status","auth":false,"desc":"Coarse fleet health: healthy/degraded + %% of machines affected"},{"method":"POST","path":"/v1/signup","auth":false,"desc":"Free API key — no payment, no browser (3 per IP per 24 h). Send {\"email\"} to keep a way back in, or NO body at all for an anonymous account where the key IS the account. Machine entry point: key, then /v1/wallet/topup, then /v1/agents"},{"method":"GET","path":"/v1/account","auth":true,"desc":"Who this key belongs to: account id, e-mail (null when anonymous), created_at"},{"method":"POST","path":"/v1/account/email","auth":true,"desc":"Bind an e-mail to an anonymous account ONCE {email} — restores sign-in-link recovery after a lost key"},{"method":"POST","path":"/v1/keys","auth":false,"desc":"Gone — use POST /v1/signup, or sign in with your e-mail at api.mintbot.ai/"},{"method":"POST","path":"/v1/orders","auth":true,"desc":"Create a new agent (setup order)"},{"method":"POST","path":"/v1/orders/boost","auth":true,"desc":"Top up an agent's credit"},{"method":"POST","path":"/v1/orders/renewal","auth":true,"desc":"Extend an agent's lifetime"},{"method":"GET","path":"/v1/orders/{order_id}","auth":true,"desc":"Get order status (poll while pending)"},{"method":"POST","path":"/v1/orders/{order_id}/check","auth":true,"desc":"Force an immediate payment recheck"},{"method":"GET","path":"/v1/agents","auth":true,"desc":"List all agents owned by your key"},{"method":"POST","path":"/v1/agents","auth":true,"desc":"Order an agent from your EUR wallet (billing_period 4h | 24h | month; channels [telegram, web] or headless [] + ssh_key_id; portal keys)"},{"method":"GET","path":"/v1/agents/{agent_id}","auth":true,"desc":"Get full agent info"},{"method":"GET","path":"/v1/agents/{agent_id}/usage","auth":true,"desc":"Per-model LLM spend (last 30 days)"},{"method":"POST","path":"/v1/agents/{agent_id}/credit","auth":true,"desc":"Add LLM credit to an agent from your EUR wallet {amount_eur} (portal keys)"},{"method":"POST","path":"/v1/agents/{agent_id}/chat","auth":true,"desc":"Chat with your agent through our proxy"},{"method":"POST","path":"/v1/agents/{agent_id}/link-telegram","auth":true,"desc":"Bind a Telegram user_id to this agent"},{"method":"DELETE","path":"/v1/agents/{agent_id}","auth":true,"desc":"Permanently destroy agent + VPS (?confirm=true)"},{"method":"POST","path":"/v1/webhooks","auth":true,"desc":"Register an outbound webhook (HMAC-signed POSTs)"},{"method":"GET","path":"/v1/webhooks","auth":true,"desc":"List webhooks for your key"},{"method":"GET","path":"/v1/webhooks/{id}/deliveries","auth":true,"desc":"Recent delivery attempts for a webhook"},{"method":"DELETE","path":"/v1/webhooks/{id}","auth":true,"desc":"Delete a webhook"},{"method":"GET","path":"/v1/wallet","auth":true,"desc":"EUR wallet balance + last 50 ledger entries (portal keys)"},{"method":"POST","path":"/v1/wallet/topup","auth":true,"desc":"Start a wallet top-up (amount_eur 5–500) — returns a checkout URL"},{"method":"GET","path":"/v1/wallet/spend","auth":true,"desc":"Spend breakdown (top-ups / infra / LLM credit / refunds) + per-day list, ?days=30 (portal keys)"},{"method":"GET","path":"/v1/ssh-keys","auth":true,"desc":"List your account's SSH public keys (portal keys)"},{"method":"POST","path":"/v1/ssh-keys","auth":true,"desc":"Add an SSH public key {public_key, label} — pick its id as ssh_key_id for a headless agent"},{"method":"DELETE","path":"/v1/ssh-keys/{id}","auth":true,"desc":"Remove an SSH public key (placed orders keep their snapshot)"}],"docs":"https://mintbot.how/developer-api/","portal":"https://api.mintbot.ai/"}