# Kora — Full LLM Reference

## Product Overview

Kora is an AI-powered issue tracking platform for modern ops teams. It turns messy inputs — Slack messages, WhatsApp forwards, customer emails — into clean, structured tickets using AI. The platform is designed for small-to-mid-size teams that need issue tracking without per-seat pricing: Kora is pay-as-you-go, billed in credits per ticket created.

## Key Differentiators

1. **AI ticket structuring** — Paste raw text, get a structured ticket with title, category, priority, and description. Unlimited and free in every workspace.
2. **Pay-as-you-go pricing** — $1 = 10 credits. A ticket costs 1 credit ($0.10). No seats, no monthly plan, no per-member fees. Members are always free.
3. **AI Analyst (text-to-SQL)** — Ask questions about ticket data in natural language. 1 credit per successful answer; failed queries are never charged.
4. **Public API** — 20+ REST API endpoints in every workspace. Webhooks with HMAC signatures and automatic retries included.
5. **Embedded Sessions** — Embed Kora into any product via iframe with a single API call. Time-limited session URLs, zero extra logins.
6. **Claim-based ownership** — Unassigned tickets are claimed by whoever picks them up; complete activity history on every ticket.
7. **EU data residency** — All data hosted in the EU (Cloudflare D1, eu).

## Pricing (as of September 2026)

Kora is pay-as-you-go with credits:

| Item | Price |
|------|-------|
| Credits | $1 = 10 credits (minimum top-up $5) |
| Ticket created (any channel) | 1 credit ($0.10) |
| AI Analyst answer | 1 credit ($0.10) |
| Public API responses | 1 credit per 400 responses |
| Comments, members | Free |
| File storage | 2 credits per 2GB per month (any fraction = full block; zero usage free) |
| AI ticket structuring | Free, unlimited |
| Webhooks, embedded sessions, CSV export | Free |

- New workspaces claim **1,100 free credits**: 1,000 bonus credits (valid 30 days) + 100 base credits (valid 10 years). No credit card required.
- Suggested top-up packs: $5, $10, $20, $50, $100, or custom. **First recharge: +30% bonus credits** (e.g. $10 → 130 credits).
- Purchased credits are valid for 10 years.
- The wallet may overdraw down to −10 credits so inbound requests are never lost; reading data is never blocked.
- Example: a 10-agent team doing 300 tickets/month with 100 AI answers pays about $40/month.
- Payments are handled by Dodo Payments (merchant of record).

## Features

### Core
- Unlimited tickets and unlimited members in every workspace
- Ticket history: unlimited (nothing is ever deleted; no plan gating)
- File storage: 50GB cap, 100MB max file size, billed monthly at 2 credits per 2GB of usage
- White label with logo upload
- Ticket merging and bulk actions (up to 100 tickets)
- Email notifications and realtime comment updates
- Role-based access: Owner, Admin, Manager, Operations, Agent, Viewer

### AI Features
- **AI Ticket Structuring**: Paste raw text → get a structured ticket with title, category, priority. Unlimited, free.
- **AI Analyst**: Natural-language questions over workspace data (text-to-SQL with safety guards), with formatted answers and CSV export. 1 credit per successful answer.

### Categories
- Managed per-workspace category list with a permanent "Other" system category
- Optional AI category creation: when AI structuring can't match a ticket, it creates a new category (workspace toggle, default off) or falls back to Other
- Rename cascades to tickets; deletion blocked while tickets use the category
- Public API: GET /public/v1/categories

### Collaboration
- Comments & attachments
- Ticket assignment (Claim Model) and assignment-based workflows
- Email notifications
- Embedded Sessions (live ticket view inside your product, no login)
- Ticket merging and bulk actions

### API & Integrations
- Public REST API: 20+ endpoints (tickets, comments, attachments, sessions, analytics, members, webhooks)
- Available in every workspace — no feature gating
- Webhooks for 7 ticket event types with HMAC-SHA256 signatures, delivery logs, and exponential-backoff retries
- Rate limiting: 50,000 requests/day for funded wallets, 5,000/day when the wallet is empty; per-workspace custom limits supported

### SLA Tracking (shipped)
- Per-priority response & resolution targets, business-hours calendars with holidays, pause-while-waiting, breach alerts (email + webhook), compliance reporting. Free on every workspace.

### Automation Rules (shipped)
- If-this-then-that rules: triggers (ticket created, status/priority/assignee changed, comment added, SLA breached, no-response-for-N-hours), conditions (category, priority, status, title, description, reporter email, ticket source), actions (set priority, set status, assign, add comment, fire webhook, send email to members, re-run AI structuring). Free on every workspace. Includes dry-run testing, run history, rule ordering, and per-workspace/rule rate caps.

### Helpdesk (shipped)
- Blog-style knowledge base: public, branded help center at usekora.app/p/helpdesk/<your-link> with article listing, search (full-text), helpful votes and a light/dark/system theme toggle. Claim up to 5 custom links; every old link keeps working. Notion-style editor ("/" blocks: headings, lists, quotes, code, tables, images, videos via YouTube/Vimeo/Loom embeds or MP4/WebM upload), per-article slug/meta/cover/visibility (public or unlisted)/SEO-sitemap switch, revisions with restore, 7-day draft share links, email subscriptions with CSV export, and built-in analytics (visitors, pageviews, referrers, top articles, zero-result searches). Pricing: 1 credit per published article (once — unlimited free edits); public reads, search, votes and subscriptions free; attachments meter into storage. Webhook events article.published / article.updated. Public API: GET /public/v1/articles, /public/v1/articles/:slug. Help widget mode: KoraWidget { mode: 'help', workspace: 'slug' }. Kora's own helpdesk: https://usekora.app/p/helpdesk/kora.

### Coming Soon (honest roadmap)
- Email-to-ticket auto-capture (shared inbox)
- AI reply drafting (copilot) for agents
- Live chat widget
- Customer portal
- Slack integration

## Competitor Comparisons

### Kora vs Freshdesk
- Freshdesk: From $15/agent/month. AI add-on $29/agent/month.
- Kora: Pay-as-you-go credits — $1 = 10 credits, 1 credit per ticket, 1,100 free credits on signup.
- Kora wins on: pricing model (pay per ticket, not per seat), AI pricing, API access on the free tier, EU data residency.
- Freshdesk wins on: omnichannel, marketplace apps (1,000+), knowledge base, SLA tracking.

### Kora vs Zoho Desk
- Zoho Desk: From $7/agent/month. AI features at Enterprise level ($40/agent).
- Kora: Pay-as-you-go credits; unlimited members free.
- Kora wins on: pricing model, AI pricing, API on the free tier, EU data residency.
- Zoho Desk wins on: omnichannel, Zoho ecosystem integration, knowledge base.

### Kora vs Zendesk
- Zendesk: From $19/agent/month. AI add-on $50/agent/month.
- Kora: Pay-as-you-go credits; unlimited members free.
- Kora wins on: pricing model, AI pricing, API on the free tier, EU data residency, simplicity.
- Zendesk wins on: omnichannel, marketplace apps (1,500+), knowledge base, SLA tracking.

### Kora vs Jira Service Management
- Jira SM: From $20/agent/month. AI included on Standard+.
- Kora: Pay-as-you-go credits; unlimited members free.
- Kora wins on: pricing model, AI pricing, API on the free tier, EU data residency, simplicity.
- Jira SM wins on: Atlassian ecosystem, ITSM depth (change/asset management), marketplace apps.

## API Overview

The Kora Public API is a REST API with 20+ endpoints at https://api.usekora.app. Authentication uses `X-Workspace-ID` and `X-Secret-Key` headers (secret key stored hashed; shown once at generation). Available in every workspace.

Key endpoints:
- `GET /public/v1/categories` — List workspace categories with ticket counts
- `GET /public/v1/workspace` — Workspace summary with live counts
- `GET /public/v1/tickets` — List tickets (pagination, date filters)
- `POST /public/v1/tickets` — Create a ticket (1 credit)
- `GET /public/v1/tickets/:id` — Get a ticket
- `PATCH /public/v1/tickets/:id` — Update a ticket
- `POST /public/v1/tickets/:id/claim` — Claim a ticket
- `POST /public/v1/tickets/:id/merge` — Merge tickets
- `POST /public/v1/tickets/bulk` — Bulk update up to 100 tickets
- `GET/POST /public/v1/tickets/:id/comments` — List/add comments
- `GET /public/v1/tickets/:id/comments/since` — Incremental comment polling
- `GET/POST /public/v1/tickets/:id/attachments` — List/upload attachments
- `GET /public/v1/dashboard/metrics` — Workspace analytics
- `GET/POST /public/v1/members` — List/invite members
- `GET/POST/PATCH/DELETE /public/v1/webhooks` — Manage webhooks
- `POST /public/v1/sessions` — Create an embedded session

Complete product knowledge base (all features, pricing, comparisons): https://usekora.app/know-all-about-kora.html

Full API documentation: https://usekora.app/docs

## Data & Security

- EU data residency (Cloudflare, Europe)
- Secret keys stored as SHA-256 hashes; webhook secrets AES-256-GCM encrypted
- Rate limiting per workspace with X-RateLimit headers
- Signed, expiring URLs for file downloads
- Webhook payloads signed with HMAC-SHA256
- No data sold to third parties; GDPR compliant