# Failed public agent and team runs return a sanitized 503

> A failed agent or team run on an Agno PublicSurface returns a sanitized 503 run_failed with a correlation_id, and nothing from the run itself.

- Published: 2026-09-08
- Author: Ashpreet Bedi
- Categories: Changelog
- Canonical: https://www.agno.com/articles/failed-public-agent-and-team-runs-return-a-sanitized-503
- Markdown: https://www.agno.com/articles/failed-public-agent-and-team-runs-return-a-sanitized-503.md

When an agent or team run on an Agno `PublicSurface` fails, the caller gets a short JSON error with a `run_failed` code and a `correlation_id`. Model errors and provider messages stay on your server.

```http
HTTP/1.1 503 Service Unavailable
Content-Type: application/json

{"error": {"code": "run_failed", "message": "run failed", "correlation_id": "9f2c…"}}
```

AgentOS logs a warning with the same correlation ID, so when a user reports an error you can find the request in your logs. A streaming run that fails ends with a `RunError` or `TeamRunError` event carrying the same code and ID.

Learn more about [Public Surface](https://docs.agno.com/agent-os/public-surface) in the documentation.