Ingest events

axiom.ingestEvents ingests 1–10,000 structured JSON events into one dataset. edgeUrl defaults to the US East 1 (AWS) edge at https://us-east-1.aws.edge.axiom.co; set it to the edge that stores the target dataset. The result includes ingested, failed, processedBytes, blocksCreated, walLength, and optional per-event failures.

automations/axiom-ingest-events.automation.ts

import { automation, onHttpRequest } from "automate.ax"
import { axiom } from "automate.ax/axiom"

export default automation("Ingest events", () => {
  onHttpRequest({ scope: "automation" })
  axiom.ingestEvents({
    datasetName: "production",
    events: [{ service: "api", level: "info", message: "Started" }],
  })
})

Inputs

Input	Required	Default	Description
`datasetName`	Yes	—	Target dataset name or ID.
`events`	Yes	—	Array of 1–10,000 JSON objects.
`edgeUrl`	No	`"https://us-east-1.aws.edge.axiom.co"`	Axiom ingest edge or an HTTPS `*.edge.axiom.co` origin.

Output

Returns ingested, failed, processedBytes, blocksCreated, and walLength. When individual events fail validation, failures contains their error and timestamp. Check failed even when the action succeeds because Axiom can accept part of a batch.

Permission and failures

The API token needs the dataset-level ingest|create capability for datasetName. Axiom’s edge data endpoint supports API tokens, not personal access tokens. Axiom rejects missing or inaccessible datasets and malformed events. Request-rate limits return 429, while exhausted ingest limits return 430; Automate.ax uses Axiom’s reset timing when available. This mutation is not retried automatically after an ambiguous provider response.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Inputs

Output

Permission and failures

​Inputs

​Output

​Permission and failures

Inputs

Output

Permission and failures