Skip to main content
POST
/
v1
/
events
/
batch
Ingest up to 1000 audit events
curl --request POST \
  --url https://api.fact0.io/v1/events/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "actor": {
        "id": "<string>",
        "email": "<string>"
      },
      "action": "<string>",
      "resource": {
        "id": "<string>",
        "type": "<string>",
        "name": "<string>"
      },
      "id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ]
}
'
{
  "accepted": 123,
  "rejected": 123,
  "ids": [
    "<string>"
  ],
  "errors": [
    {
      "index": 123,
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.fact0.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key prefixed with alk_live_. Write scope required for ingest.

Headers

X-Fact0-Sync
enum<string>

Set to true for synchronous ingest

Available options:
true

Query Parameters

sync
enum<string>

Set to true for synchronous ingest

Available options:
true

Body

application/json
events
object[]
required
Maximum array length: 1000

Response

Batch committed (sync mode)

accepted
integer
rejected
integer
ids
string[]
errors
object[]