# AgentsPodium Account API

**Canonical:** https://apis.io/apis/agentspodium-com/account-api/  
**Provider:** AgentsPodium — https://apis.io/providers/agentspodium-com/  
**Base URL:** https://agentspodium.com/api  
**Documentation:** https://hosting.defispace.com/docs/

AgentsPodium Account API is one of 3 APIs that [AgentsPodium](https://apis.io/providers/agentspodium-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include AI Agents, Agent Hosting, Hosting, Webhook, and Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

The HTTP API behind the AgentsPodium dashboard, published as an agent-facing subset (OpenAPI 3.1.0, 52 operations): passwordless sign-in and API keys, the public catalog of personas, tiers, engines, tools and models, the full pod lifecycle (create, upgrade, configure model key / tools / channels / instructions / peers, pause, resume, rebuild, delete), health and quota, backups and export, payment by card, USDT/USDC or Telegram Stars, signed webhooks, custom domains and the public A2A directory. Bearer ak_live_ key or 30-day session token; eleven operations are public.

## Operations (52)

| Method | Path | Summary |
|---|---|---|
| POST | `/auth/request` | Request a six-digit sign-in code by e-mail. |
| POST | `/auth/verify` | Exchange an e-mail code for a bearer token. |
| GET | `/keys` | List this account's API keys. |
| POST | `/keys` | Mint a new API key for this account. |
| DELETE | `/keys/{id}` | Revoke an API key. |
| GET | `/personas` | List the public persona catalog. |
| GET | `/personas/{id}` | Read one persona's full catalog entry. |
| GET | `/tiers` | List the pricing plans and the trial length. |
| GET | `/engines` | List the platforms (engines) that can be deployed. |
| GET | `/tools` | List Hermes toolsets available to enable on an agent. |
| GET | `/models` | List the curated LLM model catalog. |
| GET | `/llm-providers` | List LLM providers Hermes can take a key for. |
| GET | `/status` | Check whether the platform itself is healthy. |
| GET | `/agents` | List every agent (pod) owned by this account. |
| POST | `/agents` | Create a new agent (deploy a pod). |
| GET | `/agents/{id}` | Read one agent's full record. |
| DELETE | `/agents/{id}` | Delete an agent for good. |
| POST | `/agents/{id}/upgrade` | Change an agent's plan. |
| PATCH | `/agents/{id}/llm-key` | Install, change, or clear the agent's model key. |
| PATCH | `/agents/{id}/tools` | Set the agent's enabled toolsets and MCP servers. |
| PATCH | `/agents/{id}/channels` | Set which messengers the agent listens on. |
| PATCH | `/agents/{id}/telegram` | Install or clear the agent's Telegram bot token. |
| PATCH | `/agents/{id}/instructions` | Set the owner's extra instructions appended to the persona. |
| PATCH | `/agents/{id}/timezone` | Set the IANA timezone the agent's schedules run on. |
| PUT | `/agents/{id}/peers` | Replace the list of other agents this one may call over A2A. |
| PATCH | `/agents/{id}/listing` | Opt an agent into (or out of) the public A2A catalog. |
| POST | `/agents/{id}/pause` | Pause an agent (stop billing its resources). |
| POST | `/agents/{id}/resume` | Resume a paused agent. |
| POST | `/agents/{id}/rebuild` | Rebuild the pod from its last backup. |
| GET | `/agents/{id}/liveness` | Check whether the pod is up and the engine inside is answering. |
| GET | `/agents/{id}/usage` | Read the agent's current RAM/disk usage against its plan. |
| GET | `/agents/{id}/term` | Find out when this agent's current free or paid term ends. |
| GET | `/agents/{id}/export` | Download a tarball of the agent's own data. |
| POST | `/agents/{id}/backup` | Take an off-pod snapshot right now. |
| GET | `/agents/{id}/backups` | List server-side snapshots for this agent. |
| GET | `/agents/{id}/memory` | Inspect what a Hermes agent currently remembers. |
| GET | `/subscriptions` | List this account's subscriptions across all agents. |
| GET | `/subscriptions/providers` | List available (and coming-soon) payment providers. |
| POST | `/agents/{id}/activate` | Activate a paid subscription for an agent with a license key. |
| GET | `/crypto/info` | Read crypto payment configuration and supported assets. |
| POST | `/agents/{id}/crypto-order` | Open a USDT/USDC deposit order for an agent's plan. |
| GET | `/agents/{id}/crypto-orders` | List crypto orders opened for this agent. |
| GET | `/stars/info` | Read Telegram Stars payment configuration. |
| POST | `/agents/{id}/stars-order` | Open a Telegram Stars payment order for an agent's plan. |
| GET | `/agents/{id}/stars-orders` | List Telegram Stars orders opened for this agent. |
| GET | `/domains/check` | Check what a customer's own domain currently answers. |
| GET | `/a2a-catalog` | List agents whose owners opted into the public A2A directory. |
| PUT | `/agents/{id}/webhook` | Set the URL that receives signed events about this agent's pod. |
| DELETE | `/agents/{id}/webhook` | Stop sending events for this agent. |
| POST | `/agents/{id}/webhook/test` | Deliver a `test` event to the webhook right now and report how it went. |
| PATCH | `/agents/{id}/app` | Change what an app instance builds and how it starts. |
| GET | `/agents/{id}/build` | Find out how the last build of an app instance went. |

## Machine-readable artifacts (19)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/openapi/agentspodium-com-openapi.yml
- **OpenAPI** — https://hosting.defispace.com/openapi.json
- **Documentation** — https://hosting.defispace.com/docs/
- **APIReference** — https://hosting.defispace.com/openapi.json
- **GettingStarted** — https://hosting.defispace.com/docs/quickstart.html
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/authentication/agentspodium-com-authentication.yml
- **Authentication** — https://hosting.defispace.com/docs/auth.html
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/conventions/agentspodium-com-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/errors/agentspodium-com-problem-types.yml
- **ErrorCatalog** — https://hosting.defispace.com/docs/errors.html
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/rate-limits/agentspodium-com-rate-limits.yml
- **RateLimits** — https://hosting.defispace.com/docs/limits.html
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/asyncapi/agentspodium-com-webhooks.yml
- **Webhooks** — https://hosting.defispace.com/docs/webhooks.html
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/data-model/agentspodium-com-data-model.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/overlays/agentspodium-com-openapi-overlay.yaml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/lifecycle/agentspodium-com-lifecycle.yml
- **StatusPage** — https://agentspodium.com/api/status
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/apis.yml

## Other AgentsPodium APIs (2)

- [AgentsPodium Hosting MCP Server](https://apis.io/apis/agentspodium-com/mcp-server/)
- [AgentsPodium Hosting A2A Agent](https://apis.io/apis/agentspodium-com/a2a-agent/)

## Tags

AI Agents, Agent Hosting, Hosting, Webhook, Payments

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentspodium-com/account-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentspodium-com/.