Skip to Content
Podyard

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

FieldDescription
planYour current plan ID: free, hobby, pro, or team
maxConcurrentPodsMax pods that can be running simultaneously
maxLifetimeHoursMax hours a single pod can exist before forced destroy
execTimeoutSecondsDefault exec timeout (can be overridden per-call, capped here)
maxConcurrentExecsMax concurrent exec calls on a single pod
execMaxOutputBytesMax combined stdout+stderr bytes before elision
maxFileSizeBytesMax single file size for FS writes
maxPodVfsBytesMax total pod virtual filesystem size
snapshotQuotaMax active snapshots
templateQuotaMax active templates
storageGiBTotal storage allocation in GiB
rateLimitRpmSustained requests per minute (token bucket refill)
rateLimitBurstMax burst tokens (token bucket capacity)
networkPolicyPod outbound network policy: default-deny
sleepAfterMinutesIdle minutes before auto-sleep
sleepWakeWhether sleep/wake is enabled for this plan

Errors: 401 unauthorized.

WHERE_TO_GO_NEXT

  • Usage — current consumption.
  • Errors — full error code reference.