Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Marlie AI 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmarlie.ai%2Fmarlie-ai" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmarlie.ai%2Fmarlie-ai" | 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 Marlie AI API.
List all AI voice calls handled by Marlie for the connected business
Fetch the transcript and metadata for a specific call by ID
Retrieve the business profile linked to the API token
Pull aggregated analytics on call volume and outcomes
Filter call lists for downstream CRM or reporting sync
GET STARTED
Patterns agents use Marlie AI API for, with concrete tasks.
★ CRM Call Logging
Service businesses using Marlie as their AI voice receptionist need every handled call logged into their CRM. The Marlie API exposes a list-calls endpoint plus per-call detail, so a sync job can pull new calls hourly and create matching CRM activity records with the full transcript attached.
Call `GET /calls` filtered to the last hour and create a CRM activity record for each new call_id with the transcript pulled from `GET /calls/{call_id}`.
Call Analytics Dashboard
Owners of small businesses want a daily view of how many calls Marlie answered, how many resulted in bookings, and trend lines over time. The `/analytics/calls` endpoint returns aggregated counts that a dashboard can render directly without computing rollups client-side.
Call `GET /analytics/calls` and render the daily total-calls and answered-calls counts for the past 30 days.
Missed Call Follow-up
When the AI agent flags a call as needing a human follow-up, the business owner wants a quick list of those calls each morning. The list endpoint returns enough metadata (timestamp, caller, outcome) to triage which calls a team member should return personally.
Call `GET /calls` filtered to outcomes that require follow-up and produce a morning summary email of caller numbers and reasons.
AI Agent Customer Support Briefing
A customer-support AI agent can use Jentic to fetch a caller's most recent Marlie call before responding to a follow-up email, so it has the right context. Jentic stores the bearer token and exposes Marlie's small operation set behind intent-based search, keeping integration trivial for downstream agents.
Search Jentic for 'fetch latest ai voice call', load the Marlie `/calls` schema, and execute it filtered by today to brief the support agent.
4 endpoints — jentic publishes the only available openapi specification for marlie ai api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/calls
List AI voice calls
/calls/{call_id}
Fetch transcript and metadata for one call
/business
Retrieve the business profile
/analytics/calls
Aggregated call analytics
/calls
List AI voice calls
/calls/{call_id}
Fetch transcript and metadata for one call
/business
Retrieve the business profile
/analytics/calls
Aggregated call analytics
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Marlie AI by hand means setting its bearer auth, learning the /calls, /business, and /analytics paths, and parsing the call and transcript records yourself. Through Jentic you install once, import the Marlie AI API from the API Directory, store the token once, and your agent calls it.
Permission scoping
The Marlie endpoints are read-only call and analytics lookups, so scoping is by operation: you limit the agent to the operations it needs, such as listing calls, reading a call transcript, or fetching call analytics, and leave out the rest. Every operation you allow is one you have chosen, so the agent stays inside that set.
Credential isolation
Your Marlie AI bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'list AI voice calls' or 'get a call transcript', and Jentic returns the matching Marlie operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Marlie AI API through Jentic.
Why is there no official OpenAPI spec for Marlie AI API?
Marlie AI does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the Marlie AI API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Marlie AI API use?
Marlie AI uses HTTP bearer-token authentication. Through Jentic, the token is stored encrypted in your Jentic One instance and the `Authorization: Bearer ...` header is applied automatically when the agent executes a call.
Can I retrieve call transcripts with the Marlie AI API?
Yes. `GET /calls/{call_id}` returns the full transcript and metadata for a specific call. Use `GET /calls` first to list call IDs from the time window you care about.
What are the rate limits for the Marlie AI API?
Marlie AI does not publish hard rate limits in the spec. Given the small endpoint surface (4 endpoints), conservative client-side throttling at 1-2 requests per second per business token is sufficient for most CRM-sync workloads.
How do I sync new Marlie calls into a CRM through Jentic?
Run `pip install jentic`, then use Jentic's search with the query 'list ai voice calls'. Jentic loads the `/calls` operation schema and your agent executes it incrementally, then fetches each transcript via `/calls/{call_id}` for the CRM activity record.
Does the Marlie AI API expose call analytics?
Yes. `GET /analytics/calls` returns aggregated call metrics (volume and outcomes) so dashboards do not need to compute rollups client-side.
Can I limit what my agent is allowed to do with the Marlie AI API?
Yes. Because you run Jentic One yourself, your own rules decide which Marlie operations the agent may call and which credentials it may use. The Marlie endpoints are all read-only lookups, so you can allow just the operations the agent needs, such as listing calls with GET /calls, reading a transcript with GET /calls/{call_id}, or fetching analytics with GET /analytics/calls, and leave out the rest. Every operation the agent can reach is one you explicitly permitted, and its bearer token stays encrypted in your instance rather than in the agent's context.
Know of an official OpenAPI document? Contribute it →
For Agents
Pull AI voice call records, fetch individual call transcripts, and retrieve call-volume analytics for a Marlie-connected business.
Use for: List all AI calls Marlie handled this week for my business, Get the transcript for call id call_abc123, Retrieve my Marlie business profile and connected phone number, Show me call analytics for the last 30 days
Not supported: Does not place outbound calls, configure the voice agent's prompts, or stream audio in real time - use for retrieving call records, transcripts, and analytics only.
Jentic publishes the only available OpenAPI specification for Marlie AI API, keeping it validated and agent-ready. Marlie AI provides a small, focused interface to retrieve AI voice-call records and call analytics for a connected business. Customers use it to pull historical call lists, fetch a single call's transcript and metadata, look up business profile information, and read aggregated call analytics. The API is intended for businesses that have deployed Marlie's AI voice agent and want to feed call outcomes into reporting, CRMs, or downstream automations.