43.14.1Privacy Notice Endpoint

43.14.1.2.1Get Current Privacy Notice

Retrieves the current privacy notice content and metadata.

URL: GET /admin-json/privacy-notice

Required Permissions: ACCESS_ADMIN_JSON

Response:

{
  "content": "This is the privacy notice content...",
  "version": "2025.01.15",
  "isActive": true,
  "expiryDays": 90
}

Response Fields:

• content (string): The privacy notice text content
• version (string): The current version identifier of the privacy notice
• isActive (boolean): Whether the privacy notice is active (has both content and version)
• expiryDays (integer): Number of days after which acceptance expires

43.14.1.2.2Get User Acceptance Status

Checks the current user's privacy notice acceptance status.

URL: GET /admin-json/privacy-notice/status

Required Permissions: ACCESS_ADMIN_JSON

Response:

{
  "isRequired": true,
  "currentVersion": "2025.01.15"
}

Response Fields:

• isRequired (boolean): Whether the user needs to accept the current privacy notice
• currentVersion (string): The current version of the privacy notice

43.14.1.2.3Accept Privacy Notice

Records the user's acceptance of the current privacy notice version.

URL: POST /admin-json/privacy-notice/accept

Required Permissions: ACCESS_ADMIN_JSON

Request Body:

{
  "version": "2025.01.15"
}

Request Fields:

• version (string): The version of the privacy notice being accepted (must match current version)

Response:

{
  "success": true,
  "acceptedDate": "2025-01-15T10:30:00Z"
}

Response Fields:

• success (boolean): Whether the acceptance was successfully recorded
• acceptedDate (string): ISO-8601 timestamp when the acceptance was recorded

43.14.1.3.1Version Mismatch (400 Bad Request)

When attempting to accept a privacy notice version that doesn't match the current version:

{
  "error": "Version mismatch: attempted to accept version '2025.01.10' but current version is '2025.01.15'"
}

43.14.1.3.2Authentication Required (400 Bad Request)

When authentication is missing or invalid:

{
  "error": "Authentication is required"
}

43.14.1.3.3Internal Server Error (500 Internal Server Error)

When the service encounters an unexpected error:

{
  "error": "Failed to retrieve privacy notice: [error details]"
}