LIMITS
Retrieve your plan's current limits.
LIMITS
GET /v1/limits returns the full limits object for your current plan. This is the API's way of letting clients discover what's allowed without hardcoding values.
Base: https://api.podyard.dev/v1
GET /v1/limits — Get plan limits
Headers: Authorization: Bearer <key>.
Response 200:
{
"plan": "hobby",
"limits": {
"maxConcurrentPods": 5,
"maxLifetimeHours": 168,
"execTimeoutSeconds": 600,
"maxConcurrentExecs": 16,
"execMaxOutputBytes": 8388608,
"maxFileSizeBytes": 268435456,
"maxPodVfsBytes": 4294967296,
"snapshotQuota": 50,
"templateQuota": 25,
"storageGiB": 10,
"rateLimitRpm": 300,
"rateLimitBurst": 100,
"networkPolicy": "default-deny",
"sleepAfterMinutes": 30,
"sleepWake": true
}
}All values are sourced from @podyard/config — the single source of truth. If a value changes in config, it changes here automatically.
FIELD_DESCRIPTIONS
| Field | Description |
|---|---|
plan | Your current plan ID: free, hobby, pro, or team |
maxConcurrentPods | Max pods that can be running simultaneously |
maxLifetimeHours | Max hours a single pod can exist before forced destroy |
execTimeoutSeconds | Default exec timeout (can be overridden per-call, capped here) |
maxConcurrentExecs | Max concurrent exec calls on a single pod |
execMaxOutputBytes | Max combined stdout+stderr bytes before elision |
maxFileSizeBytes | Max single file size for FS writes |
maxPodVfsBytes | Max total pod virtual filesystem size |
snapshotQuota | Max active snapshots |
templateQuota | Max active templates |
storageGiB | Total storage allocation in GiB |
rateLimitRpm | Sustained requests per minute (token bucket refill) |
rateLimitBurst | Max burst tokens (token bucket capacity) |
networkPolicy | Pod outbound network policy: default-deny |
sleepAfterMinutes | Idle minutes before auto-sleep |
sleepWake | Whether sleep/wake is enabled for this plan |
Errors: 401 unauthorized.