AgentsPodium Agents API

Create, configure, and operate a pod.

Documentation GitHub OpenAPI

Operations 29

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 #