API Reference

Errors

GROUNDROCK normalizes every provider error to a single taxonomy. Every response includes a canonical error code and the raw provider payload for debugging.

Property	Type	Description
`invalid_request`	`400`	Malformed request or unsupported parameter.
`unauthorized`	`401`	Missing or invalid API key.
`forbidden`	`403`	Key valid but scope denies this action.
`not_found`	`404`	Model or resource does not exist.
`rate_limited`	`429`	Project rate limit exceeded. Retry with backoff.
`quota_exceeded`	`402`	Spend cap or credits exhausted.
`provider_error`	`502`	Upstream provider returned an error.
`provider_timeout`	`504`	Upstream provider timed out.
`unavailable`	`503`	GROUNDROCK edge in this region is degraded. Automatic failover in progress.