Troubleshooting

Common error symptoms grouped by what you’ll see, why it happened, and how to fix it.

Symptom	When it happens
`circuit_breaker_open`	Agent suspended after 3 consecutive failures
`scope_not_granted`	Agent called a scope not in its permission matrix
`approval_expired`	Owner didn’t decide within 24 hours
`invalid_signature`	Agent’s JWT didn’t verify against its registered public key
PII redaction 502	Presidio errored while redacting; proxy fails closed

For everything else, the error envelope includes a correlation_id — quote it when you email support@agentvalet.ai and we can pull the audit row immediately.

If your agent received an error and you want to lodge a structured self-report tied to the failure, use report_self_diagnostic — the proxy embeds a report_hint payload in every error response that makes the report a one-call followup.