For Agents
Manage customers, products, variants, sales orders, tax rates, and locations in a Katana MRP tenant. 8 endpoints covering the core inventory and order lifecycle.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Katana 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 Katana API.
Authenticate to Katana with the /oauth/token endpoint to obtain a bearer token
Resolve and create customer records via /api/Customers/findOne and /api/Customers
Look up product variants and their stock through /api/Variants
GET STARTED
Use for: I need to create a sales order in Katana for a Shopify customer, Look up a product variant by SKU in Katana, List all warehouse locations configured in Katana, Find the tax rate to apply for an order shipping to California
Not supported: Does not handle accounting ledgers, shipping label generation, or storefront product display — use for Katana customer, variant, sales-order, tax-rate, and location operations only.
Jentic publishes the only available OpenAPI specification for Katana API, keeping it validated and agent-ready. Katana is a manufacturing resource planning (MRP) platform used by small and mid-sized makers to manage production, inventory, and sales orders. The API exposes customers, products, variants, sales orders, tax rates, and locations along with an OAuth token endpoint for authentication. It is the integration surface that lets accounting, e-commerce, and shipping tools stay in sync with what is being made and shipped from the warehouse floor.
List configured tax rates and warehouse locations via /api/taxRates and /api/Locations
Create and list sales orders via /sales-orders with customer, location, and product line references
Authorise downstream Katana users programmatically via /api/KatanaUsers/authorize
Patterns agents use Katana API for, with concrete tasks.
★ E-Commerce Order Sync to MRP
Push every Shopify or BigCommerce order into Katana as a sales order so the production team sees real demand, not just storefront receipts. The /sales-orders endpoint accepts customer, location, and variant references in a single call, and /api/Customers/findOne resolves repeat buyers without creating duplicate records. End-to-end wiring is typically a day for a one-storefront firm.
Resolve the Shopify customer via POST /api/Customers/findOne, then create a Katana sales order via POST /sales-orders with the matching variant SKUs and shipping location.
Stock Lookup for Sales Quotes
Quote sales reps real stock before they commit a delivery date by reading product variant availability from Katana via /api/Variants. The variant payload exposes on-hand and committed quantities per location, so a quote tool can reject an oversold order before it reaches the production team. Removes a recurring source of customer dissatisfaction for makers running near capacity.
Fetch the variant matching SKU 'WIDGET-RED-L' via GET /api/Variants and return on-hand stock at the primary location.
Tax and Location Configuration Mirror
Mirror Katana's tax rates and warehouse locations into a CRM or quoting tool so reps see the same options that production sees. /api/taxRates and /api/Locations are read-only lookups; cache them daily and reuse the values when constructing sales orders to avoid mismatches on tax computation or origin warehouse assignment.
Cache /api/taxRates and /api/Locations responses daily and use them to populate dropdowns in the quoting tool.
Agent-Driven Production Operations
Production-floor AI assistants use Jentic to query Katana when an operator asks 'how many red widgets do we have?' or 'create a sales order for Acme'. Jentic handles the OAuth dance via /oauth/token and stores the bearer in the vault, so the assistant never has to refresh tokens or expose credentials in chat.
Use the Jentic search 'create a Katana sales order', load the schema, and execute POST /sales-orders for the supplied customer and variant.
8 endpoints — jentic publishes the only available openapi specification for katana api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/oauth/token
Exchange credentials for a bearer token
/api/Customers/findOne
Find a customer by filter
/api/Customers
Create a customer
/api/taxRates
List tax rates
/api/Locations
List warehouse locations
/api/Variants
List product variants with stock
/sales-orders
Create a sales order
/oauth/token
Exchange credentials for a bearer token
/api/Customers/findOne
Find a customer by filter
/api/Customers
Create a customer
/api/taxRates
List tax rates
/api/Locations
List warehouse locations
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Katana OAuth client credentials and resulting bearer token are held encrypted in the Jentic vault. Agents receive scoped execution tokens, so the OAuth secret and the bearer never enter the agent's prompt.
Intent-based discovery
Agents search by intent (for example, 'create a Katana sales order' or 'check variant stock') and Jentic returns the matching path with body schema, sparing the agent from reading Katana's developer documentation.
Time to first call
Direct Katana integration: 1-2 days for OAuth handling, variant resolution, and sales-order construction. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Katana API through Jentic.
Why is there no official OpenAPI spec for Katana API?
Katana does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Katana 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 Katana API use?
The API uses HTTP bearer tokens. Clients call POST /oauth/token to exchange Katana credentials for a bearer, then send `Authorization: Bearer {token}` on every subsequent call. Through Jentic the credential exchange happens server-side and the bearer never reaches the agent.
Can I create a sales order with multiple line items in Katana?
Yes. POST /sales-orders accepts a customer ID, location ID, and an array of line items referencing variants and quantities. Resolve unknown variants first via GET /api/Variants and unknown customers via POST /api/Customers/findOne to avoid creating duplicate records.
What are the rate limits for the Katana API?
Katana applies per-tenant throttling and returns HTTP 429 on bursts. The platform is sized for SMB manufacturing traffic, so steady polling for stock and order status (every minute or two) sits well within the limit. Use cached /api/taxRates and /api/Locations responses to keep request volume down.
How do I create a Katana sales order through Jentic?
Run `pip install jentic` and search Jentic for 'create a Katana sales order'. Jentic returns the schema for POST /sales-orders; supply the customer ID, location ID, and line item array, then execute. The bearer token is injected from the Jentic vault.
Does the Katana API expose stock levels per variant?
Yes. GET /api/Variants returns each variant with its on-hand and committed quantities per location, which lets a quoting tool reject orders that would oversell available stock at the chosen warehouse.
Is the Katana API included in every plan?
API access is included with Katana paid plans. The trial tier is limited and high-volume integrations may need an Advanced plan to lift API quotas.
/api/Variants
List product variants with stock
/sales-orders
Create a sales order