Events

Run a bulk action

POST/v1/events/bulk

Applies one action to up to 500 events.

Parameters

Body parameters3

actionstringRequired

retry, redrive, replay or cancel.

idsstring[]Required

Event IDs. Anything past 500 is ignored.

destination?string

For replay: where to send the copies.

Returns

200The sample response is on the right.Errors return error and message; see Errors and limits.

POSTRun a bulk action

curl -X POST "https://api.getensue.com/v1/events/bulk" \
  -H "authorization: Bearer $ENSUE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"action":"retry","ids":["evt_…"]}'

const res = await fetch("https://api.getensue.com/v1/events/bulk", {
  method: "POST",
  headers: {
    authorization: `Bearer ${process.env.ENSUE_API_KEY}`,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "action": "retry",
    "ids": [
      "evt_…"
    ]
  }),
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.getensue.com/v1/events/bulk",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
    json={
      "action": "retry",
      "ids": [
        "evt_…"
      ]
    },
)
print(res.json())

200Response

{
  "cancelled": 2
}

{"cancelled":2}