Request a new decision

post/v1/decisions

Submit content for review and receive a decision ID to track the results. The decision is processed asynchronously.

Body ParametersExpand Collapse

content: map[string or number or boolean or array of string]

The data to be reviewed. The structure depends on the type of content.

Accepts one of the following:

UnionMember0 = string

UnionMember1 = number

UnionMember2 = boolean

UnionMember3 = array of string

type: string

The type of content to review

metadata: optional map[string or number or boolean]

Customer metadata as key-value pairs

Accepts one of the following:

UnionMember0 = string

UnionMember1 = number

UnionMember2 = boolean

ReturnsExpand Collapse

decision_id: string

Unique identifier for the decision

metadata: map[string or number or boolean]

Customer metadata as key-value pairs

Accepts one of the following:

UnionMember0 = string

UnionMember1 = number

UnionMember2 = boolean

type: string

Type of content to review

Request a new decision

curl https://api.safetykit.com/v1/decisions \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $SAFETYKIT_API_KEY" \
    -d '{
          "content": {
            "url": "https://www.example.com/products/42"
          },
          "type": "product_review",
          "metadata": {
            "user_id": "user-456",
            "batch_name": "Daily review"
          }
        }'

{
  "decision_id": "content_01h2m7qdmdjckc30e1mnq6xqfd",
  "metadata": {},
  "type": "product_review"
}

Returns Examples

{
  "decision_id": "content_01h2m7qdmdjckc30e1mnq6xqfd",
  "metadata": {},
  "type": "product_review"
}