Check Multiple Events

POST

api

events

cURL

curl --request POST \
  --url https://eu.whitecircle.com/api/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'whitecircle-version: <whitecircle-version>' \
  --data '
{
  "environment_id": "environment_123",
  "run_id": "run_refund_123",
  "external_session_id": "conversation_456",
  "events": [
    {
      "type": "message",
      "role": "user",
      "content": "Can you refund my order 4815?",
      "event_id": "evt_user_001"
    },
    {
      "type": "tool",
      "name": "lookup_order",
      "output": {
        "order_id": "4815",
        "refund_eligible": true
      },
      "event_id": "evt_tool_001",
      "call_id": "call_abc"
    }
  ]
}
'

import requests

url = "https://eu.whitecircle.com/api/events"

payload = {
    "environment_id": "environment_123",
    "run_id": "run_refund_123",
    "external_session_id": "conversation_456",
    "events": [
        {
            "type": "message",
            "role": "user",
            "content": "Can you refund my order 4815?",
            "event_id": "evt_user_001"
        },
        {
            "type": "tool",
            "name": "lookup_order",
            "output": {
                "order_id": "4815",
                "refund_eligible": True
            },
            "event_id": "evt_tool_001",
            "call_id": "call_abc"
        }
    ]
}
headers = {
    "whitecircle-version": "<whitecircle-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'whitecircle-version': '<whitecircle-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    environment_id: 'environment_123',
    run_id: 'run_refund_123',
    external_session_id: 'conversation_456',
    events: [
      {
        type: 'message',
        role: 'user',
        content: 'Can you refund my order 4815?',
        event_id: 'evt_user_001'
      },
      {
        type: 'tool',
        name: 'lookup_order',
        output: {order_id: '4815', refund_eligible: true},
        event_id: 'evt_tool_001',
        call_id: 'call_abc'
      }
    ]
  })
};

fetch('https://eu.whitecircle.com/api/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://eu.whitecircle.com/api/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'environment_id' => 'environment_123',
    'run_id' => 'run_refund_123',
    'external_session_id' => 'conversation_456',
    'events' => [
        [
                'type' => 'message',
                'role' => 'user',
                'content' => 'Can you refund my order 4815?',
                'event_id' => 'evt_user_001'
        ],
        [
                'type' => 'tool',
                'name' => 'lookup_order',
                'output' => [
                                'order_id' => '4815',
                                'refund_eligible' => true
                ],
                'event_id' => 'evt_tool_001',
                'call_id' => 'call_abc'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "whitecircle-version: <whitecircle-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eu.whitecircle.com/api/events"

	payload := strings.NewReader("{\n  \"environment_id\": \"environment_123\",\n  \"run_id\": \"run_refund_123\",\n  \"external_session_id\": \"conversation_456\",\n  \"events\": [\n    {\n      \"type\": \"message\",\n      \"role\": \"user\",\n      \"content\": \"Can you refund my order 4815?\",\n      \"event_id\": \"evt_user_001\"\n    },\n    {\n      \"type\": \"tool\",\n      \"name\": \"lookup_order\",\n      \"output\": {\n        \"order_id\": \"4815\",\n        \"refund_eligible\": true\n      },\n      \"event_id\": \"evt_tool_001\",\n      \"call_id\": \"call_abc\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("whitecircle-version", "<whitecircle-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://eu.whitecircle.com/api/events")
  .header("whitecircle-version", "<whitecircle-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"environment_id\": \"environment_123\",\n  \"run_id\": \"run_refund_123\",\n  \"external_session_id\": \"conversation_456\",\n  \"events\": [\n    {\n      \"type\": \"message\",\n      \"role\": \"user\",\n      \"content\": \"Can you refund my order 4815?\",\n      \"event_id\": \"evt_user_001\"\n    },\n    {\n      \"type\": \"tool\",\n      \"name\": \"lookup_order\",\n      \"output\": {\n        \"order_id\": \"4815\",\n        \"refund_eligible\": true\n      },\n      \"event_id\": \"evt_tool_001\",\n      \"call_id\": \"call_abc\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://eu.whitecircle.com/api/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["whitecircle-version"] = '<whitecircle-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"environment_id\": \"environment_123\",\n  \"run_id\": \"run_refund_123\",\n  \"external_session_id\": \"conversation_456\",\n  \"events\": [\n    {\n      \"type\": \"message\",\n      \"role\": \"user\",\n      \"content\": \"Can you refund my order 4815?\",\n      \"event_id\": \"evt_user_001\"\n    },\n    {\n      \"type\": \"tool\",\n      \"name\": \"lookup_order\",\n      \"output\": {\n        \"order_id\": \"4815\",\n        \"refund_eligible\": true\n      },\n      \"event_id\": \"evt_tool_001\",\n      \"call_id\": \"call_abc\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "flagged": false,
  "messages": [
    {
      "type": "message",
      "status": "completed",
      "flagged": false,
      "policies": {
        "01930000-0000-7000-8000-000000000001": {
          "flagged": false,
          "name": "PII disclosure",
          "enabled_by_conditions": [
            {
              "id": "01930000-0000-7000-8000-000000000002",
              "name": "EU users"
            }
          ]
        }
      },
      "event_id": "evt_user_001",
      "internal_event_id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890"
    }
  ],
  "artifacts": [],
  "tools": [
    {
      "type": "tool",
      "status": "completed",
      "flagged": false,
      "policies": {},
      "note": "No policies or metrics were selected for this Event",
      "event_id": "evt_tool_001",
      "internal_event_id": "b2c3d4e5-f6a7-4901-bcde-f23456789012"
    }
  ],
  "functions": [],
  "agents": [],
  "reasoning": [],
  "run_id": "run_refund_123"
}

Check up to 50 Events in one request. Use this endpoint when you want to submit several related pieces of an interaction together, such as a user message, a tool result, and an assistant response.

How It Works

You submit an events array containing 1 to 50 Event payloads
Conditions select the applicable Policies and Metrics for each Event
White Circle evaluates Policies synchronously and queues Metrics asynchronously
You receive one response with Policy results grouped by Event type

Batch requests preserve result order within each typed bucket, but results are grouped by type: messages, artifacts, tools, functions, agents, and reasoning.

List Events in the order they happened. Each Event is checked against the Events listed before it. See Event Context.

Each Event payload uses the same shape as Check One Event.

Conditions in a Batch

Conditions are evaluated separately for each Event. Put metadata on every Event that needs metadata-based Policy selection; metadata from one Event does not apply to another Event in the same batch.

{
  "environment_id": "environment_123",
  "events": [
    {
      "type": "message",
      "role": "user",
      "content": "Can you refund my order?",
      "metadata": { "user": { "region": "eu" } }
    },
    {
      "type": "tool",
      "name": "lookup_order",
      "output": { "refund_eligible": true },
      "metadata": { "workflow": { "stage": "refund_review" } }
    }
  ]
}

If no active Condition matches an Event, no Policies are evaluated and no Metrics are queued for that Event, even if another Event in the batch matched a Condition.

Selected Metrics run asynchronously and are not included in the synchronous typed result buckets. See Conditions for routing behavior.

Response Overview

Each result includes type, status, event_id, and internal_event_id, plus flagged, policies, and note when applicable. Each Policy result can include enabled_by_conditions with the Conditions that selected it.

A batch reports each verdict on its own result, because one request checks many Events. The single-Event response instead reports the verdict once at the top level. See Check One Event.

Send include_shadow=true at the top level to also return shadow-mode Policies for every Event in the batch, each marked shadow: true. Shadow results never change any top-level flagged verdict.

Same-Batch References

A reference-only Event can point to another Event with content in the same batch. White Circle resolves same-batch references before looking up previous results.

{
  "events": [
    {
      "type": "agent",
      "state": {
        "phase": "reviewing_refund"
      },
      "event_id": "evt_agent_state"
    },
    {
      "type": "agent",
      "event_id": "evt_agent_state"
    }
  ],
  "environment_id": "environment_123",
  "run_id": "run_batch_ref"
}

The second Event returns referenced if the first Event completes successfully.

Referencing Existing Events

If a reference-only Event does not match an Event with content in the same batch, White Circle looks up the latest result with the same run_id and event_id. The reference returns:

Status	Meaning
`referenced`	A matching result exists and has the same Event type.
`not_found`	No matching Event exists, or the latest matching Event has a different type.

Repeated Event IDs

You can submit multiple Events with content using the same event_id. White Circle checks and saves each one, and each completed check receives a different internal_event_id.

Use different event_id values when each Event should have its own application ID.

Partial Failures

Some per-Event validation failures return a failed result while the rest of the batch continues. For example, an invalid inline artifact can return status: "failed" while other Events are checked. Request-level shape and relationship errors return 400 and reject the whole batch. This includes more than 50 Events, self-parenting, direct mutual parents involving a previously saved Event, and parent cycles declared within the batch.

Authorizations

Authorization

string

header

required

API Key required. Format: Bearer wc-your-api-key

Headers

whitecircle-version

string

required

API Version

Body

application/json

environment_id

string

required

events

object[]

required

Required array length: 1 - 50 elements

Hide child attributes

events.type

enum<string>

required

Available options:

message,

artifact,

tool,

function,

agent,

reasoning

events.role

string | null

events.content

any

events.delta

any

events.arguments

any

events.output

any

events.definition

any

events.input

any

events.instructions

any

events.state

any

events.event_id

string | null

events.run_id

string | null

events.external_session_id

string | null

events.parent_event_id

string | null

events.links

object[]

Hide child attributes

events.links.event_id

string

required

events.links.run_id

string | null

events.external_artifact_id

string | null

events.name

string | null

events.call_id

string | null

events.stream_id

string | null

events.sequence

integer<int64> | null

events.format

string | null

events.timestamp

string<date-time> | null

events.metadata

any

run_id

string | null

external_session_id

string | null

role

string | null

include_shadow

boolean | null

Also return shadow-policy results (each marked shadow: true). Shadow results never affect the top-level flagged/violation verdict.

Response

Success

flagged

boolean

required

messages

object[]

required

Hide child attributes

messages.type

enum<string>

required

Available options:

message,

artifact,

tool,

function,

agent,

reasoning

messages.status

enum<string>

required

Available options:

completed,

failed,

referenced,

not_found

messages.event_id

string

required

messages.flagged

boolean | null

messages.policies

object | null

Hide child attributes

messages.policies.{key}

object

Hide child attributes

messages.policies.{key}.flagged

boolean

required

messages.policies.{key}.name

string

required

messages.policies.{key}.enabled_by_conditions

object[] | null

The Conditions that selected this Policy for this Event, which is why it was evaluated at all.

Hide child attributes

messages.policies.{key}.enabled_by_conditions.id

string

required

messages.policies.{key}.enabled_by_conditions.name

string

required

messages.policies.{key}.shadow

boolean

Present and true only for shadow policies surfaced via include_shadow. A shadow result never affects the top-level verdict.

messages.note

string | null

messages.internal_event_id

string | null

artifacts

object[]

required

Hide child attributes

artifacts.type

enum<string>

required

Available options:

message,

artifact,

tool,

function,

agent,

reasoning

artifacts.status

enum<string>

required

Available options:

completed,

failed,

referenced,

not_found

artifacts.event_id

string

required

artifacts.flagged

boolean | null

artifacts.policies

object | null

Hide child attributes

artifacts.policies.{key}

object

Hide child attributes

artifacts.policies.{key}.flagged

boolean

required

artifacts.policies.{key}.name

string

required

artifacts.policies.{key}.enabled_by_conditions

object[] | null

The Conditions that selected this Policy for this Event, which is why it was evaluated at all.

Hide child attributes

artifacts.policies.{key}.enabled_by_conditions.id

string

required

artifacts.policies.{key}.enabled_by_conditions.name

string

required

artifacts.policies.{key}.shadow

boolean

Present and true only for shadow policies surfaced via include_shadow. A shadow result never affects the top-level verdict.

artifacts.note

string | null

artifacts.internal_event_id

string | null

tools

object[]

required

Hide child attributes

tools.type

enum<string>

required

Available options:

message,

artifact,

tool,

function,

agent,

reasoning

tools.status

enum<string>

required

Available options:

completed,

failed,

referenced,

not_found

tools.event_id

string

required

tools.flagged

boolean | null

tools.policies

object | null

Hide child attributes

tools.policies.{key}

object

Hide child attributes

tools.policies.{key}.flagged

boolean

required

tools.policies.{key}.name

string

required

tools.policies.{key}.enabled_by_conditions

object[] | null

The Conditions that selected this Policy for this Event, which is why it was evaluated at all.

Hide child attributes

tools.policies.{key}.enabled_by_conditions.id

string

required

tools.policies.{key}.enabled_by_conditions.name

string

required

tools.policies.{key}.shadow

boolean

Present and true only for shadow policies surfaced via include_shadow. A shadow result never affects the top-level verdict.

tools.note

string | null

tools.internal_event_id

string | null

functions

object[]

required

Hide child attributes

functions.type

enum<string>

required

Available options:

message,

artifact,

tool,

function,

agent,

reasoning

functions.status

enum<string>

required

Available options:

completed,

failed,

referenced,

not_found

functions.event_id

string

required

functions.flagged

boolean | null

functions.policies

object | null

Hide child attributes

functions.policies.{key}

object

Hide child attributes

functions.policies.{key}.flagged

boolean

required

functions.policies.{key}.name

string

required

functions.policies.{key}.enabled_by_conditions

object[] | null

The Conditions that selected this Policy for this Event, which is why it was evaluated at all.

Hide child attributes

functions.policies.{key}.enabled_by_conditions.id

string

required

functions.policies.{key}.enabled_by_conditions.name

string

required

functions.policies.{key}.shadow

boolean

Present and true only for shadow policies surfaced via include_shadow. A shadow result never affects the top-level verdict.

functions.note

string | null

functions.internal_event_id

string | null

agents

object[]

required

Hide child attributes

agents.type

enum<string>

required

Available options:

message,

artifact,

tool,

function,

agent,

reasoning

agents.status

enum<string>

required

Available options:

completed,

failed,

referenced,

not_found

agents.event_id

string

required

agents.flagged

boolean | null

agents.policies

object | null

Hide child attributes

agents.policies.{key}

object

Hide child attributes

agents.policies.{key}.flagged

boolean

required

agents.policies.{key}.name

string

required

agents.policies.{key}.enabled_by_conditions

object[] | null

The Conditions that selected this Policy for this Event, which is why it was evaluated at all.

Hide child attributes

agents.policies.{key}.enabled_by_conditions.id

string

required

agents.policies.{key}.enabled_by_conditions.name

string

required

agents.policies.{key}.shadow

boolean

Present and true only for shadow policies surfaced via include_shadow. A shadow result never affects the top-level verdict.

agents.note

string | null

agents.internal_event_id

string | null

reasoning

object[]

required

Hide child attributes

reasoning.type

enum<string>

required

Available options:

message,

artifact,

tool,

function,

agent,

reasoning

reasoning.status

enum<string>

required

Available options:

completed,

failed,

referenced,

not_found

reasoning.event_id

string

required

reasoning.flagged

boolean | null

reasoning.policies

object | null

Hide child attributes

reasoning.policies.{key}

object

Hide child attributes

reasoning.policies.{key}.flagged

boolean

required

reasoning.policies.{key}.name

string

required

reasoning.policies.{key}.enabled_by_conditions

object[] | null

The Conditions that selected this Policy for this Event, which is why it was evaluated at all.

Hide child attributes

reasoning.policies.{key}.enabled_by_conditions.id

string

required

reasoning.policies.{key}.enabled_by_conditions.name

string

required

reasoning.policies.{key}.shadow

boolean

Present and true only for shadow policies surfaced via include_shadow. A shadow result never affects the top-level verdict.

reasoning.note

string | null

reasoning.internal_event_id

string | null

run_id

string

required

⌘I

cURL

curl --request POST \
  --url https://eu.whitecircle.com/api/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'whitecircle-version: <whitecircle-version>' \
  --data '
{
  "environment_id": "environment_123",
  "run_id": "run_refund_123",
  "external_session_id": "conversation_456",
  "events": [
    {
      "type": "message",
      "role": "user",
      "content": "Can you refund my order 4815?",
      "event_id": "evt_user_001"
    },
    {
      "type": "tool",
      "name": "lookup_order",
      "output": {
        "order_id": "4815",
        "refund_eligible": true
      },
      "event_id": "evt_tool_001",
      "call_id": "call_abc"
    }
  ]
}
'

import requests

url = "https://eu.whitecircle.com/api/events"

payload = {
    "environment_id": "environment_123",
    "run_id": "run_refund_123",
    "external_session_id": "conversation_456",
    "events": [
        {
            "type": "message",
            "role": "user",
            "content": "Can you refund my order 4815?",
            "event_id": "evt_user_001"
        },
        {
            "type": "tool",
            "name": "lookup_order",
            "output": {
                "order_id": "4815",
                "refund_eligible": True
            },
            "event_id": "evt_tool_001",
            "call_id": "call_abc"
        }
    ]
}
headers = {
    "whitecircle-version": "<whitecircle-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'whitecircle-version': '<whitecircle-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    environment_id: 'environment_123',
    run_id: 'run_refund_123',
    external_session_id: 'conversation_456',
    events: [
      {
        type: 'message',
        role: 'user',
        content: 'Can you refund my order 4815?',
        event_id: 'evt_user_001'
      },
      {
        type: 'tool',
        name: 'lookup_order',
        output: {order_id: '4815', refund_eligible: true},
        event_id: 'evt_tool_001',
        call_id: 'call_abc'
      }
    ]
  })
};

fetch('https://eu.whitecircle.com/api/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://eu.whitecircle.com/api/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'environment_id' => 'environment_123',
    'run_id' => 'run_refund_123',
    'external_session_id' => 'conversation_456',
    'events' => [
        [
                'type' => 'message',
                'role' => 'user',
                'content' => 'Can you refund my order 4815?',
                'event_id' => 'evt_user_001'
        ],
        [
                'type' => 'tool',
                'name' => 'lookup_order',
                'output' => [
                                'order_id' => '4815',
                                'refund_eligible' => true
                ],
                'event_id' => 'evt_tool_001',
                'call_id' => 'call_abc'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "whitecircle-version: <whitecircle-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eu.whitecircle.com/api/events"

	payload := strings.NewReader("{\n  \"environment_id\": \"environment_123\",\n  \"run_id\": \"run_refund_123\",\n  \"external_session_id\": \"conversation_456\",\n  \"events\": [\n    {\n      \"type\": \"message\",\n      \"role\": \"user\",\n      \"content\": \"Can you refund my order 4815?\",\n      \"event_id\": \"evt_user_001\"\n    },\n    {\n      \"type\": \"tool\",\n      \"name\": \"lookup_order\",\n      \"output\": {\n        \"order_id\": \"4815\",\n        \"refund_eligible\": true\n      },\n      \"event_id\": \"evt_tool_001\",\n      \"call_id\": \"call_abc\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("whitecircle-version", "<whitecircle-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://eu.whitecircle.com/api/events")
  .header("whitecircle-version", "<whitecircle-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"environment_id\": \"environment_123\",\n  \"run_id\": \"run_refund_123\",\n  \"external_session_id\": \"conversation_456\",\n  \"events\": [\n    {\n      \"type\": \"message\",\n      \"role\": \"user\",\n      \"content\": \"Can you refund my order 4815?\",\n      \"event_id\": \"evt_user_001\"\n    },\n    {\n      \"type\": \"tool\",\n      \"name\": \"lookup_order\",\n      \"output\": {\n        \"order_id\": \"4815\",\n        \"refund_eligible\": true\n      },\n      \"event_id\": \"evt_tool_001\",\n      \"call_id\": \"call_abc\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://eu.whitecircle.com/api/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["whitecircle-version"] = '<whitecircle-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"environment_id\": \"environment_123\",\n  \"run_id\": \"run_refund_123\",\n  \"external_session_id\": \"conversation_456\",\n  \"events\": [\n    {\n      \"type\": \"message\",\n      \"role\": \"user\",\n      \"content\": \"Can you refund my order 4815?\",\n      \"event_id\": \"evt_user_001\"\n    },\n    {\n      \"type\": \"tool\",\n      \"name\": \"lookup_order\",\n      \"output\": {\n        \"order_id\": \"4815\",\n        \"refund_eligible\": true\n      },\n      \"event_id\": \"evt_tool_001\",\n      \"call_id\": \"call_abc\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "flagged": false,
  "messages": [
    {
      "type": "message",
      "status": "completed",
      "flagged": false,
      "policies": {
        "01930000-0000-7000-8000-000000000001": {
          "flagged": false,
          "name": "PII disclosure",
          "enabled_by_conditions": [
            {
              "id": "01930000-0000-7000-8000-000000000002",
              "name": "EU users"
            }
          ]
        }
      },
      "event_id": "evt_user_001",
      "internal_event_id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890"
    }
  ],
  "artifacts": [],
  "tools": [
    {
      "type": "tool",
      "status": "completed",
      "flagged": false,
      "policies": {},
      "note": "No policies or metrics were selected for this Event",
      "event_id": "evt_tool_001",
      "internal_event_id": "b2c3d4e5-f6a7-4901-bcde-f23456789012"
    }
  ],
  "functions": [],
  "agents": [],
  "reasoning": [],
  "run_id": "run_refund_123"
}

First Steps

Use Cases

Integrations

Events

Conditions

Artifacts

Policy

Metric

User

Billing

How It Works

Conditions in a Batch

Response Overview

Same-Batch References

Referencing Existing Events

Repeated Event IDs

Partial Failures

Authorizations

Headers

Body

Response

​How It Works

​Conditions in a Batch

​Response Overview

​Same-Batch References

​Referencing Existing Events

​Repeated Event IDs

​Partial Failures

Authorizations

Headers

Body

Response

How It Works

Conditions in a Batch

Response Overview

Same-Batch References

Referencing Existing Events

Repeated Event IDs

Partial Failures