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
| Status | Meaning |
|---|---|
400 | Invalid request or unsupported action |
401 | Missing or invalid authentication |
404 | Resource not found |
409 | Resource conflict |
422 | Validation error |
502 | Upstream 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.