Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Ninetailed Events API

Batch event ingestion endpoints for profile enrichment.

Ninetailed Events API is one of 2 APIs that Ninetailed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Events. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, and defines 8 schemas. It is described by OpenAPI 3.0.1, at version 2.

Requests are made against a single base URL, https://experience.ninetailed.co/v2/organizations/{organizationId}/environments/{environmentSlug}.

2 operations 2 paths 8 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2
Base URL
https://experience.ninetailed.co/v2
License
Proprietary
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Events 2

Batch event ingestion endpoints for profile enrichment.

POST
/events
Batch Upsert Events (Synchronous)
batchUpsertSync 1 param body → 200400429500
POST
/import/events
Batch Upsert Events (Asynchronous)
batchUpsertAsync body → 200400500

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are Profile (9 properties), Event (7 properties), Location (6 properties), Session (5 properties). Each schema is shown below with its type and property counts.

Session
object
Session-level metadata for the visitor.
5 properties
Location
object
Geographic location resolved from the visitor's IP address.
6 properties
AsyncConfirmation
object
Confirmation that an asynchronous import request was accepted.
3 properties
BatchEventsResponse
object
Response envelope for synchronous batch events, containing profile updates without experiences.
3 properties
Profile
object
A visitor profile containing identity, behavioral, and session data used for personalization.
9 properties
BatchEventsRequest
object
Request body for batch event ingestion. Maximum 200 events, 50 identify events, 50 unique profiles per request.
1 property 1 required
ApiError
object
Error response envelope.
3 properties 2 required
Event
object
A behavioral or identity event associated with a visitor profile.
7 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ninetailed-events-api-openapi.yml Raw ↑

Other APIs Ninetailed publishes across the network.

Ninetailed Profiles API