Skip to main content
Each entry in requests is a group: one content plus a list of questions about it — so asking several questions about the same content sends that content only once, and a single call can still mix groups with different content.
/decide/batch requires the same API key header as /decide. See Authentication.

​
Request

Each question can carry its own optional grounding (grounding is no longer part of the group; sort questions still reject it). 
{
  "requests": [
    {
      "content": "User post: 'Selling verified Instagram accounts, DM for bulk pricing.'",
      "questions": [
        {"id": "policy_violation", "kind": "yesno", "instructions": "Does this post violate marketplace policy?"},
        {
          "id": "harm_level",
          "kind": "scale",
          "instructions": "How harmful is this content to the platform?",
          "levels": [
            {"level": 0, "description": "No meaningful harm — safe to leave published"},
            {"level": 1, "description": "Low harm — minor policy edge case"},
            {"level": 2, "description": "Moderate harm — misleading or low-grade abuse"},
            {"level": 3, "description": "High harm — fraud, spam, or user safety risk"},
            {"level": 4, "description": "Severe harm — active scam or imminent user damage"}
          ]
        }
      ]
    }
  ]
}
To batch decisions about different content, add more groups: 
{
  "requests": [
    {"content": "doc A", "questions": [{"id": "a1", "kind": "yesno", "instructions": "urgent?"}]},
    {"content": "doc B", "questions": [{"id": "b1", "kind": "yesno", "instructions": "urgent?"}]}
  ]
}

​
Response

Batch responses are nested by group, then by question:
  • results: one item per group (matches requests 1:1)
  • results[i].answers: one item per question in that group’s questions, in order
  • results[i].answers[j].ok: success flag for that question (.result holds the decision, or .error the message)
  • meta.request_count: number of groups
  • meta.question_count: total questions across all groups (the billing unit — see Pricing)