Record an agent decision

POST/v1/agent_decisions

Record a human reviewer’s final verdict for content that SafetyKit has previously reviewed. This feedback lets SafetyKit measure and improve automated decisions over time. Each request provides feedback for one content object and one policy category. If a content object is reviewed for multiple policy categories, send one request per policy category.

Body ParametersJSONExpand Collapse

content_type: string

The SafetyKit data namespace or content type for the content being reviewed

decision: string

The human reviewer’s verdict for the policy category.

policy_id: string

The SafetyKit policy category ID that was evaluated, as configured for your account

reference_id: string

Stable identifier for the content object in your system

action: optional string

Optional correct enforcement action for this content, such as ‘reduce_visibility’ or ‘unpublish’

agent_type: optional string

Optional type of review that produced this decision, such as ‘appeal’, ‘bpo_review’, or ‘policy_expert’

comment: optional string

Additional context or details from the human reviewer

ReturnsExpand Collapse

safetykitCorrect: boolean

Whether SafetyKit’s decision matched the submitted agent decision

Record an agent decision

curl https://api.safetykit.com/v1/agent_decisions \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $SAFETYKIT_API_KEY" \
    -d '{
          "content_type": "product_listing",
          "decision": "no_match",
          "policy_id": "counterfeit",
          "reference_id": "listing_12345"
        }'

{
  "safetykitCorrect": true
}

Returns Examples

{
  "safetykitCorrect": true
}