Ingest a batch of events

Validates and persists up to 1000 events in one request. Partial success is allowed: each event's outcome is reported individually in results. The response is 200 whenever the batch was well-formed, even if some events failed validation.

Request body (optional)

eventsobject[]required

typestringrequired

Event type — see GET /events/types.

dataobject

Type-specific payload, validated against the event's schema.

Responses

200Per-event ingestion result

acceptednumberrequired

rejectednumberrequired

resultsobject[]required

indexnumberrequired

typestringrequired

statusenumrequired

acceptedrejected

errorstringrequired

400Malformed batch

errorstringrequired

Sending requests from a browser

Open https://v3.revolutionstreetwxs.io/api/v3/docs to send requests to this endpoint with your API key.

Request

curl -X POST 'https://v3.revolutionstreetwxs.io/api/v3/events/batch' \
  -H "Authorization: Bearer wxs_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "events": [
    {
      "type": "scan",
      "data": {}
    }
  ]
}'

const response = await fetch("https://v3.revolutionstreetwxs.io/api/v3/events/batch", {
  method: "POST",
  headers: {
    Authorization: "Bearer wxs_pk_YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "events": [
      {
        "type": "scan",
        "data": {}
      }
    ]
  }),
});
const data = await response.json();

import requests

response = requests.post(
    "https://v3.revolutionstreetwxs.io/api/v3/events/batch",
    headers={"Authorization": "Bearer wxs_pk_YOUR_API_KEY"},
    json={
      "events": [
        {
          "type": "scan",
          "data": {}
        }
      ]
    },
)
data = response.json()

Response 200

{
  "accepted": 1.5,
  "rejected": 1.5,
  "results": [
    {
      "index": 1.5,
      "type": "type",
      "status": "accepted",
      "error": "error"
    }
  ]
}