AgentsPodium

AgentsPodium Account API

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.

GitHub OpenAPI

Operations 52

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.

Documentation

📖
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
📖
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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/openapi/agentspodium-com-openapi.yml
⚙
OpenAPI
https://hosting.defispace.com/openapi.json

Other Resources

🔗
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
🔗
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/account-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agentspodium-com-openapi.yml Raw ↑ 
# Verbatim conversion of https://hosting.defispace.com/openapi.json (fetched 2026-09-19; server Last-Modified Sun, 13 Sep 2026 19:31:55 GMT).
# JSON original preserved at openapi/_original/agentspodium-com-openapi.json. Content unchanged; YAML serialisation only.
openapi: 3.1.0
info:
  title: AgentsPodium account API (agent-facing subset)
  version: 1.0.0
  description: 'Create, configure, pay for and watch AI agent pods, meant to be driven directly by an agent. This document covers the subset an agent (rather than a human operator) needs: auth, agent lifecycle, tools/models/personas catalog, payment, A2A directory. See https://hosting.defispace.com/docs/quickstart.md for a narrative walkthrough.'
servers:
- url: https://agentspodium.com/api
security:
- bearerAuth: []
tags:
- name: Auth
  description: Sign in.
- name: API keys
  description: Machine credentials for agents.
- name: Catalog
  description: 'Read-only reference data: personas, tiers, engines, tools, models, providers.'
- name: Agents
  description: Create, configure, and operate a pod.
- name: Payment
  description: Subscriptions and payment providers.
- name: A2A
  description: The public agent-to-agent directory.


# --- truncated at 32 KB (109 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/openapi/agentspodium-com-openapi.yml