Import one file of agent events into the caller's organization.

curl --request POST \
  --url https://app.befailproof.ai/v1/events/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/octet-stream' \
  --data '<string>'

import requests

url = "https://app.befailproof.ai/v1/events/import"

payload = "<string>"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/octet-stream"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/octet-stream'},
  body: '<string>'
};

fetch('https://app.befailproof.ai/v1/events/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Events

Import one file of agent events into the caller's organization.

The body is the file itself, optionally gzipped (detected from its bytes). The format is detected from the content unless format names it: our event JSONL, a Claude Code transcript, or a Codex rollout. Transcripts are converted exactly as the failproofaid collector converts them live, secrets are redacted, and every event is stamped ingest_source: "upload" and uploaded_by: <who>. Sessions already present in the organization are skipped whole. dry_run=true reports what would happen and stores nothing.

POST

/

events

/

import

Import one file of agent events into the caller's organization.

curl --request POST \
  --url https://app.befailproof.ai/v1/events/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/octet-stream' \
  --data '<string>'

import requests

url = "https://app.befailproof.ai/v1/events/import"

payload = "<string>"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/octet-stream"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/octet-stream'},
  body: '<string>'
};

fetch('https://app.befailproof.ai/v1/events/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Authorizations

Authorization

string

header

required

A scoped AgentEye API key. Mint one in the dashboard under Settings → API keys, or with POST /v1/keys. Each endpoint names the permission it requires; a key without it gets 403 and a required_permission field naming what was missing.

Query Parameters

format

string

auto (default), agenteye, claude or codex.

path

string

The file's path relative to what was dropped, e.g. -home-me-repo/0b5c….jsonl. Claude and Codex take the session id from it, and a Claude subagent its parent session. A trailing .gz is ignored.

environment

string

Environment for events that do not name one. Default upload.

dry_run

boolean

Convert and report; store nothing.

existing_before

integer<int64>

Unix milliseconds. A session counts as already present only when it has rows ingested before this. Pass the dry run's checked_at, so the later files of a session this import created are not skipped as "existing". Default: now.

Body

application/octet-stream

One file: event JSONL, a Claude Code transcript or a Codex rollout. Gzip is accepted.

The body is of type string.

Response

File processed (or, with dry_run, previewed).