API ReferenceErrors & Rate Limits

Errors & Rate Limits

Error shape

{
  "detail": "Provider not connected. Add your runpod API key in Settings → Provider Keys."
}

Some endpoints may also return structured validation errors from FastAPI.

Common statuses

StatusMeaning
400Invalid request or unsupported action
401Missing or invalid authentication
404Resource not found
409Resource conflict
422Validation error
502Upstream provider failure

Common examples

  • launching without a connected provider key
  • stopping a provider that does not support stop
  • requesting a GPU that is unavailable on the selected provider
  • provider-side API failures during launch or termination

Rate limits

Pulserun may apply request limits per auth token or API key. If you hit a limit, slow down and retry with backoff.