Privacy Service error codes privacy-service-error-codes
Use this reference to identify Privacy Service job outcomes, diagnose failures, and determine appropriate next steps when submitting or monitoring privacy jobs in Adobe Experience Platform. To learn how to create, submit, and monitor privacy jobs, see the privacy jobs endpoint guide or the Privacy Service UI user guide.
Privacy Service error codes are a stable public contract. Each error code uniquely identifies a failure or completion state that you can rely on for programmatic handling and operational workflows.
The following guarantees apply when building automation or monitoring workflows:
- Error codes are stable once published.
- Error messages may change to improve clarity, but the code value does not.
- New error codes may be added over time; existing codes are not repurposed.
Use error codes, not message text, to implement automation or decision logic. For guidance on efficiently processing privacy jobs, monitoring job status, and handling errors without relying on polling or message strings, see Privacy Service best practices.
Error response format error-response-format
Privacy Service returns error information in job and request responses. The response includes a numeric error code and a human-readable message in the response payload.
The error code conveys the authoritative outcome. The message provides additional context for troubleshooting.
This document describes the meaning and intent of each error code. For field-level response schemas and request details, see the Privacy Service API documentation.
Error domains error-domains
Error codes are grouped by functional domain to help you diagnose issues more quickly.
The domains used in this document include:
- Request validation: The request is malformed or contains invalid values. See the privacy jobs endpoint guide for request structure and validation requirements.
- Authorization and provisioning: Your organization or user lacks the required access. See manage permissions to review role-based permission requirements.
- Identity and applicability: Identifiers or namespaces are not applicable to the request. See identity data for privacy requests for supported identity types and namespace requirements.
- Rate limiting: Submission volume exceeds platform limits. When this error occurs, reduce the submission rate and try again.
- Data access and processing: The system cannot access or process the requested data. See the troubleshooting guide for common causes and remediation steps.
- Encryption and key management: Required encryption keys are unavailable. See Customer Managed Keys for key access, configuration, and recovery guidance.
- Job execution state: The job completed fully, partially, or with failures. See the privacy jobs endpoint guide for descriptions of job status categories and their meanings.
Error code reference error-code-reference
The following table lists all public Privacy Service error codes.