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 Profiles API

Operations for creating, reading, updating, and deleting visitor profiles.

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

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

This API exposes 4 operations across 2 paths, and defines 12 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}.

4 operations 2 paths 12 schemas 1 DELETE1 GET2 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 4

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

Profiles 4

Operations for creating, reading, updating, and deleting visitor profiles.

POST
/profiles
Create Profile
createProfile 2 params body → 200400404429500
GET
/profiles/{profileId}
Get Profile
getProfile 2 params → 200404500
POST
/profiles/{profileId}
Update Profile
updateProfile 3 params body → 200400404429500
DELETE
/profiles/{profileId}
Delete Profile
deleteProfile 1 param → 200404500

Schemas 12

The contract defines 12 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
ProfileResponse
object
Standard envelope response containing a profile with resolved experiences and changes.
3 properties
DeleteResponse
object
Response envelope for a successful delete operation.
3 properties
ProfileRequestOptions
object
Optional configuration for the profile request.
1 property
Event
object
A behavioral or identity event associated with a visitor profile.
7 properties 1 required
Location
object
Geographic location resolved from the visitor's IP address.
6 properties
ProfileRequest
object
Request body for creating or updating a visitor profile.
2 properties 1 required
ApiError
object
Error response envelope.
3 properties 2 required
Profile
object
A visitor profile containing identity, behavioral, and session data used for personalization.
9 properties
Change
object
A content change to apply for a personalized experience, keyed by component.
4 properties
ProfileOnlyResponse
object
Response envelope containing only the profile (no experiences or changes).
3 properties
Experience
object
A resolved experience with the variant the visitor should receive.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ninetailed-profiles-api-openapi.yml Raw ↑

Other APIs Ninetailed publishes across the network.

Ninetailed Events API