---
title: "Read the agent's current RAM/disk usage against its plan."
method: GET
path: "/agents/{id}/usage"
tags: ["Agents"]
---

# Read the agent's current RAM/disk usage against its plan.

`GET /agents/{id}/usage`

## Request

- Base URL: `https://agentspodium.com/api`
- URL: `https://agentspodium.com/api/agents/{id}/usage`
- Auth: HTTP bearer

Call to check whether an agent is close to being auto-paused for exceeding its tier (quotaStatus reaches "paused"). Numbers refresh about once a minute from the cluster.

## Path parameters

- `id` string, required

## Response `200`

OK.

- object
  - `usage` AgentQuota, required: Latest RAM/disk snapshot for a pod, refreshed about once a minute from the cluster.
    - `memoryUsedBytes` integer, nullable, required
    - `memoryLimitBytes` integer, nullable, required
    - `memoryPct` number, nullable, required: memoryUsedBytes / memoryLimitBytes, or null when either side is unknown.
    - `diskUsedBytes` integer, nullable, required
    - `diskTotalBytes` integer, nullable, required
    - `diskPct` number, nullable, required
    - `status` 'ok' | 'warn' | 'grace' | 'paused', required: paused means the pod was auto-stopped for exceeding its plan.
    - `updatedAt` string, date-time, required
  - `status` 'ok' | 'warn' | 'grace' | 'paused', required

## Other responses

- `401`: Missing, invalid, expired, or revoked credential.
- `404`: No such agent, key, or persona for this account.

---

[API](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset.md) · [All operations](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/llms.txt) · [OpenAPI document](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/revisions/46b0fc821822?raw)