Skip to content
StatusSupportDashboard

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 content type configured for your account’s feedback integration. Use the exact value provided by SafetyKit; arbitrary data namespace names are not accepted.

decision: string

The human reviewer’s verdict for the policy category. Accepted values depend on the content type configured for your account; use the verdict values provided by SafetyKit.

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

reviewer_id: optional string

Stable identifier for the individual reviewer in your system, scoped to your account. Reuse the same identifier across their reviews to support reviewer-level quality analysis. This identifies the reviewer; agent_type identifies the review workflow or category.

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": "<CONTENT_TYPE>",
          "decision": "<DECISION>",
          "policy_id": "<POLICY_ID>",
          "reference_id": "listing_12345"
        }'
{
  "safetykitCorrect": true
}
Returns Examples
{
  "safetykitCorrect": true
}