For Agents
Manage Dixa conversations, agents, end users, queues, and analytics, plus configure webhooks and custom attributes through a comprehensive customer service API.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Dixa API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Dixa API.
Create and update end-user customer profiles for support routing
Pull conversation records and route them to the right team or queue
Manage agents — create, update, set presence, list team membership
Configure queues, teams, tags, and custom attributes that drive routing
GET STARTED
Use for: Create a new end-user record in Dixa, List all open conversations for a team, Update an agent's presence to busy, Find all conversations tagged with refund
Not supported: Does not host live chat widgets, voice infrastructure, or knowledge base content directly — use for conversation, agent, and end-user management only.
Jentic publishes the only available OpenAPI specification for Dixa API, keeping it validated and agent-ready. Dixa is a conversational customer service platform that brings email, chat, voice, and social messages into one agent workspace. The API exposes conversations, agents, end users, teams, queues, tags, custom attributes, analytics, and webhooks, so external systems can sync customer profiles, push messages into the right queue, and pull operational metrics for reporting. Used by brands like Wise, Deezer, and Too Good To Go.
Anonymise end users and conversations for GDPR compliance
Run analytics queries to pull metrics, filters, and analytics records
Register and manage webhooks to push events to external systems
Patterns agents use Dixa API for, with concrete tasks.
★ CRM-to-Helpdesk End User Sync
Customer service operations sync end-user records from a CRM into Dixa so agents see full customer context when a conversation arrives. POST /v1/endusers and the bulk variant create or update profiles, while PATCH lets ops keep contact details current. This avoids the agent having to ask basic identity questions during a live conversation.
POST /v1/endusers/bulk with an array of customer profiles pulled from the CRM nightly to keep Dixa end users in sync.
Agent and Team Lifecycle Management
HR and ops teams provision Dixa agents from their identity provider, assigning them to teams as they join or move. The /v1/agents endpoints support create, update, and bulk operations, and /v1/agents/{agentId}/teams returns the agent's team memberships so tools can validate routing changes before applying them.
POST /v1/agents/bulk with the new-hire list and assign each to the right team based on role data from the HR system.
GDPR Anonymisation Workflow
Privacy and legal teams handle GDPR right-to-erasure requests through PATCH /v1/endusers/{userId}/anonymize. This scrubs personally identifying information from the end user record while preserving the conversation history needed for audit. Most teams pair this with a ticketing flow to track each request through to anonymisation.
PATCH /v1/endusers/{userId}/anonymize for each verified GDPR erasure request and log the request ID against the audit trail.
Operational Analytics Pipeline
Support ops teams pull conversation metrics and filter dimensions through the /v1/analytics/metrics, /v1/analytics/records, and /v1/analytics/filter endpoints to drive their own dashboards in BI tools. POSTing to /v1/analytics/metrics or /v1/analytics/records lets teams define the slice they need rather than working off canned reports.
POST /v1/analytics/records with a filter for the past 7 days, then load the returned records into the BI warehouse for a weekly support performance dashboard.
Agent-Driven Customer Service Automation
AI agents help Dixa supervisors triage queues, anonymise users, and pull analytics through Jentic. The Dixa API key sits in the Jentic vault, so the agent can resolve intents like 'list all open conversations for the billing team' without holding credentials.
Search Jentic for 'list Dixa agents on a team', load the GET /v1/agents/{agentId}/teams operation, and execute it for the requested agent ID.
84 endpoints — jentic publishes the only available openapi specification for dixa api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/endusers
Create an end-user record
/v1/endusers/bulk
Bulk-create end-user records
/v1/endusers/{userId}/anonymize
Anonymise an end user for GDPR
/v1/agents
Create an agent
/v1/agents/bulk
Bulk-create agents
/v1/agents/{agentId}/teams
List teams an agent belongs to
/v1/analytics/records
Query analytics records
/v1/agents/presence
List agent presence states
/v1/endusers
Create an end-user record
/v1/endusers/bulk
Bulk-create end-user records
/v1/endusers/{userId}/anonymize
Anonymise an end user for GDPR
/v1/agents
Create an agent
/v1/agents/bulk
Bulk-create agents
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Dixa API key is held encrypted in the Jentic vault. Agents call Dixa through Jentic and never see the raw key — the ApiKeyAuth header is injected at execution time.
Intent-based discovery
Agents search Jentic by intent (e.g. 'list Dixa conversations' or 'anonymise an end user') and Jentic returns the matching Dixa operation with its input schema, so the agent does not browse Dixa's 84-endpoint surface.
Time to first call
Direct Dixa integration: 3-5 days to wire end-user sync, agent provisioning, analytics, and webhooks. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Dixa API through Jentic.
Why is there no official OpenAPI spec for Dixa API?
Dixa does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Dixa API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Dixa API use?
Dixa uses an API key passed in a request header (ApiKeyAuth scheme). Through Jentic the key is stored encrypted in the vault and injected at execution so the raw value never enters agent context.
Can I bulk-create end users with the Dixa API?
Yes — POST /v1/endusers/bulk accepts an array of end-user objects, which is the recommended approach for nightly CRM-to-Dixa syncs over more than a handful of records.
How do I anonymise an end user for GDPR with the Dixa API?
Call PATCH /v1/endusers/{userId}/anonymize. Personally identifying information on the end user record is scrubbed while conversation history is preserved for audit.
What are the rate limits for the Dixa API?
The OpenAPI spec does not declare specific rate limits. For high-volume workloads, prefer bulk endpoints (/v1/endusers/bulk, /v1/agents/bulk) and implement exponential backoff on 429 responses.
How do I pull conversation analytics through Jentic?
Search Jentic for 'query Dixa analytics records', load the POST /v1/analytics/records operation, and execute it with the filter payload. Jentic injects the API key at execution and returns the query results.
/v1/agents/{agentId}/teams
List teams an agent belongs to
/v1/analytics/records
Query analytics records
/v1/agents/presence
List agent presence states