Record an audit trail

POST

/v1/privacy/audit-trails

Writes a privacy audit trail entry for a sensitive action.

请求参数

Body 参数application/json必填

示例

{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "subjectID": "history.record.11111111-1111-1111-1111-111111111111",
    "scope": "diagnosticSampleRead",
    "action": "diagnosticSampleViewed",
    "target": {
        "type": "historyRecord",
        "identifier": "11111111-1111-1111-1111-111111111111",
        "classification": "p1"
    },
    "reason": "User copied a scoped diagnostic export.",
    "consentID": "44444444-4444-4444-4444-444444444444",
    "authorizationState": "authorized",
    "outcome": "succeeded",
    "metadata": {
        "exportType": "historyDiagnostics"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/privacy/audit-trails' \
--header 'Content-Type: application/json' \
--data '{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "subjectID": "history.record.11111111-1111-1111-1111-111111111111",
    "scope": "diagnosticSampleRead",
    "action": "diagnosticSampleViewed",
    "target": {
        "type": "historyRecord",
        "identifier": "11111111-1111-1111-1111-111111111111",
        "classification": "p1"
    },
    "reason": "User copied a scoped diagnostic export.",
    "consentID": "44444444-4444-4444-4444-444444444444",
    "authorizationState": "authorized",
    "outcome": "succeeded",
    "metadata": {
        "exportType": "historyDiagnostics"
    }
}'

返回响应

🟢200成功

application/json

Audit trail recorded.

Bodyapplication/json

示例

{
    "endpoint": "POST /v1/privacy/audit-trails",
    "trail": {
        "id": "55555555-5555-5555-5555-555555555555",
        "createdAt": "2026-04-01T16:20:00Z",
        "actorID": "com.hanwang.OneSay",
        "action": "diagnosticSampleViewed",
        "target": {
            "type": "historyRecord",
            "identifier": "11111111-1111-1111-1111-111111111111",
            "classification": "p1"
        },
        "reason": "User copied a scoped diagnostic export.",
        "consentID": "44444444-4444-4444-4444-444444444444",
        "authorizationState": "authorized",
        "outcome": "succeeded",
        "metadata": {
            "exportType": "historyDiagnostics"
        }
    },
    "privacyFlags": {
        "values": [
            "audit_trail_recorded"
        ]
    }
}

修改于 2026-08-26 04:04:36

Revoke a consent

List audit trails