# AgentsPodium Agents API

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

AgentsPodium Agents API is one of 9 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 Agents. 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.

Create, configure, and operate a pod.

## Operations (29)

| Method | Path | Summary |
|---|---|---|
| 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 | `/domains/check` | Check what a customer's own domain currently answers |
| 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 (16)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/openapi/agentspodium-com-agents-api-openapi.yml
- **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
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/agentspodium-com/refs/heads/main/lifecycle/agentspodium-com-lifecycle.yml
- **StatusPage** — https://agentspodium.com/api/status

## Other AgentsPodium APIs (8)

- [AgentsPodium Hosting MCP Server](https://apis.io/apis/agentspodium-com/mcp-server/)
- [AgentsPodium Hosting A2A Agent](https://apis.io/apis/agentspodium-com/a2a-agent/)
- [AgentsPodium A2A API](https://apis.io/apis/agentspodium-com/agentspodium-com-a2a-api/)
- [AgentsPodium API keys API](https://apis.io/apis/agentspodium-com/agentspodium-com-api-keys-api/)
- [AgentsPodium Auth API](https://apis.io/apis/agentspodium-com/agentspodium-com-auth-api/)
- [AgentsPodium Catalog API](https://apis.io/apis/agentspodium-com/agentspodium-com-catalog-api/)
- [AgentsPodium Payment API](https://apis.io/apis/agentspodium-com/agentspodium-com-payment-api/)
- [AgentsPodium Status API](https://apis.io/apis/agentspodium-com/agentspodium-com-status-api/)

## Tags

Agents

---

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