For Agents
Send chat requests to a Kimiya AI bot, upload training material, auto-reply to incoming messages, and manage WhatsApp and Shopify channel bindings.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Kimiya 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://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 Kimiya AI API.
Send a chat request to a Kimiya AI assistant and receive a generated reply
Upload files to retrain the assistant's knowledge base
Update existing training files when source content changes
Auto-reply to incoming Shopify or WhatsApp messages on behalf of the bot
GET STARTED
Use for: Send a chat request to my Kimiya bot and get the answer, Upload a product PDF to train the Kimiya assistant, Update the existing training file with the new pricing, Auto-reply to the latest WhatsApp message from a customer
Not supported: Does not host the underlying language model, manage CRM records, or process payments — use for sending chat requests and managing bot training and channel bindings only.
Jentic publishes the only available OpenAPI specification for Kimiya AI API, keeping it validated and agent-ready. Kimiya AI is a chatbot platform that connects a single AI assistant to multiple messaging surfaces including WhatsApp, Shopify, and external automation tools through Zapier and N8N. The API exposes operations to send chat requests, upload and update training files, auto-reply to customer messages, manage Shopify bot configuration, and register webhook listeners. Authentication uses an X-API-KEY header.
Bind a Kimiya bot to a WhatsApp number and verify the webhook
Read Shopify chat history and dashboard stats over a date range
Register and unregister N8N webhook endpoints
Patterns agents use Kimiya AI API for, with concrete tasks.
★ Shopify customer support assistant
A Shopify store can route incoming customer questions to Kimiya AI by calling POST /api/Chat/Request and returning the generated answer to the buyer. The same surface exposes GET /api/shopify/Dashboard so an operator can see how many chats the bot handled and where it deferred to a human.
POST a chat request to /api/Chat/Request with the buyer's question and return the generated reply to the Shopify chat widget.
WhatsApp auto-reply
When a WhatsApp webhook delivers an inbound message, an integration can call POST /api/Zapier/AutoReply to have Kimiya generate and send a contextual response. POST /api/whatsapp/webhook/{apikey} handles inbound delivery and GET /api/whatsapp/bindingBots binds the bot to the number.
POST the inbound WhatsApp message body to /api/Zapier/AutoReply and confirm Kimiya returned a reply that was sent on the channel.
Knowledge base retraining
When a product catalog or policy document changes, an automation can POST /api/Zapier/UploadFile with the new file or POST /api/Zapier/UpdateFile to replace an existing source. The bot picks up the new content for subsequent chat requests without manual retraining.
Detect a new policy PDF in the source folder and POST it to /api/Zapier/UploadFile to retrain the assistant.
Agent integration via Jentic
An agent can use Jentic to discover the Kimiya chat operation, load its schema, and call POST /api/Chat/Request with a user prompt. The X-API-KEY is supplied from the Jentic vault, so the agent process never sees the raw key.
Search Jentic for 'send a chat request to Kimiya AI', load POST /api/Chat/Request, and execute it with the user's question.
15 endpoints — jentic publishes the only available openapi specification for kimiya ai api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/api/Chat/Request
Send a chat request to the assistant
/api/Zapier/UploadFile
Upload a training file
/api/Zapier/UpdateFile
Update a training file
/api/Zapier/AutoReply
Auto-reply to an inbound message
/api/shopify/Dashboard
Get Shopify dashboard stats
/api/whatsapp/webhook/{apikey}
Receive a WhatsApp webhook
/api/N8N/RegisterWebhook
Register an N8N webhook
/api/Chat/Request
Send a chat request to the assistant
/api/Zapier/UploadFile
Upload a training file
/api/Zapier/UpdateFile
Update a training file
/api/Zapier/AutoReply
Auto-reply to an inbound message
/api/shopify/Dashboard
Get Shopify dashboard stats
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Kimiya X-API-KEY is stored encrypted in the Jentic vault and injected on each request. The agent process never reads the raw value or the WhatsApp webhook secrets.
Intent-based discovery
Agents search by intent, for example 'send a chat request to Kimiya AI', and Jentic returns the POST /api/Chat/Request operation with its full input schema.
Time to first call
Direct integration: a day or two to handle multi-channel webhooks, file uploads, and bot configuration. Through Jentic: under an hour for the operations actually needed.
Alternatives and complements available in the Jentic catalogue.
Specific to using Kimiya AI API through Jentic.
Why is there no official OpenAPI spec for Kimiya AI API?
Kimiya AI does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Kimiya AI 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 Kimiya AI API use?
Every request carries an X-API-KEY header. Jentic stores the key in the vault and injects it on each call, so the agent process never reads the raw value.
Can I auto-reply to WhatsApp messages with the Kimiya AI API?
Yes. POST the inbound message to /api/Zapier/AutoReply and Kimiya generates and sends a reply on the bound channel. Use POST /api/whatsapp/webhook/{apikey} to receive the inbound delivery and /api/whatsapp/bindingBots to bind the bot to the number first.
What are the rate limits for the Kimiya AI API?
The OpenAPI specification does not declare explicit rate limits. Cache the bot configuration retrieved from /api/shopify/GetBotConfig rather than fetching it on every chat, and back off if the chat endpoint returns a 429.
How do I send a chat request with the Kimiya AI API through Jentic?
Run pip install jentic, search Jentic for 'send a chat request to Kimiya AI', load the POST /api/Chat/Request operation, and execute it with the user's question. Jentic supplies the X-API-KEY header from the vault.
/api/whatsapp/webhook/{apikey}
Receive a WhatsApp webhook
/api/N8N/RegisterWebhook
Register an N8N webhook