AdCP error code (e.g., 'RATE_LIMITED', 'PRODUCT_NOT_FOUND')
Human-readable error message. Sellers: do not embed tokens, account IDs, or internal paths — this field is forwarded to ComplianceResult.failures[].adcp_error and is grader-visible beyond the request lifetime.
OptionalrecoveryRecovery classification: retry, fix the request, or give up
OptionalfieldField that caused the error
OptionalsuggestionSuggested fix from the agent. Untrusted — sanitize before rendering in HTML.
Optionalretry_Seconds to wait before retrying (transient errors). See also retryAfterMs.
OptionalretryMilliseconds to wait before retrying — convenience conversion of retry_after * 1000.
OptionaldetailsAdditional error details. Untrusted agent-controlled content — sanitize before rendering. Sellers: do not embed tokens, account IDs, or internal paths — this field is forwarded to ComplianceResult.failures[].adcp_error and is grader-visible beyond the request lifetime.
OptionalissuesStructured validation failures. Present on VALIDATION_ERROR when the seller
identifies multiple offending fields. Each item's pointer is RFC 6901 format
(e.g. /packages/0/targeting) — differs from the top-level field which uses
JSONPath-lite. For LLM self-correction, read keyword first: 'required' → add
the field, 'enum' → pick a valid value, 'type' → fix the value type.
Optionalbuyer_Buyer-actionable classification of the failure. Present when the enclosing
code/message is too coarse or carries producer-internal context that
must not cross the buyer trust boundary. code reuses the standard error
vocabulary; message is buyer-safe by spec — no vendor identifiers,
ad-server type names, internal object names, internal IDs, or stack traces
— so it may be rendered directly to a buyer UI. When present, the
enclosing recovery classifies the buyer-actionable reason. See
core/error.json's buyer_reason field for the normative contract.
OptionalsyntheticTrue when the SDK inferred this error from unstructured text (L1 compliance)
Structured AdCP error information extracted from a failed task response. Present on
TaskResult.adcpErrorwhen the agent returns a recognized error.