API Reference

Overview

The InfiniAnalytics event-tracking API lets any automation - regardless of language or platform - register the lifecycle of an execution through a single endpoint.

Base URL

All requests are made to:

url

https://api.analytics.infini.es

Always use HTTPS. A plain HTTP request is redirected with an HTTP 301 to the HTTPS URL instead of being processed.

Endpoints

Endpoint	Purpose
POST`/v1/register/`	Registers a `START`, `EVENT`, `WARNING`, `END` or `ERROR` for an execution. This is the only endpoint most integrations need.
`/v1/ping/`	Lightweight connectivity check - use it to confirm your token and network access are working before wiring up the real integration.

Request Format

Requests and responses use JSON. Set Content-Type: application/json and include your organization token in a token header (see Authentication):

bash

curl --location 'https://api.analytics.infini.es/v1/register/' \
  --header 'Content-Type: application/json' \
  --header 'token: your_organization_token' \
  --data '{
    "automation_id": "3571c1e0-88b9-4104-a0b0-f060b7fcc6eb",
    "execution_id": "2025-03-03T15:32:17.571404",
    "event": "START",
    "description": "Starting the process"
  }'

Example response (HTTP 201):

json

{
  "automation": "3571c1e0-88b9-4104-a0b0-f060b7fcc6eb",
  "execution_id": "2025-03-03T15:32:17.571404",
  "type_of_event": "START",
  "description": "Starting the process",
  "error_id": "",
  "error_description_detail": "",
  "created_at": "2025-03-03T16:00:29.998530Z"
}

Fields

Field	Required	Description
`automation_id`	Yes	The UUID of your automation in the InfiniAnalytics dashboard.
`execution_id`	Yes	A unique identifier for this run that you define - reuse it across every event of the same execution. An internal system ID or an ISO 8601 timestamp both work, as long as it does not collide with a concurrent execution.
`event`	Yes	One of START, EVENT, WARNING, END or ERROR.
`description`	No	Free text describing the event.
`error_id`	No	An error identifier. Only meaningful when event is ERROR.
`error_description`	No	Detailed error message (e.g. an exception message). Only meaningful when event is ERROR.

Responses

Status	Meaning
`201`	Created - the event was registered.
`301`	Moved Permanently - the request was made over plain HTTP; retry over HTTPS.
`401`	Unauthorized - the token header is missing or invalid.
`5xx`	Server Error - a transient issue on our side. Contact Infini support if it persists.

Full Reference

For a complete, endpoint-by-endpoint reference of all five events (START, EVENT, WARNING, ERROR and END) with request/response examples for each, see the Full Reference page.