# Kathan API

> Intelligence that just feels like human

## Docs

- [Create Api Key](https://docs.kathan.tech/api-reference/api-keys/create-api-key.md): Generate a new API key for the authenticated user.
- [Delete Api Key](https://docs.kathan.tech/api-reference/api-keys/delete-api-key.md): Delete an API key for the authenticated user.
- [List Api Keys](https://docs.kathan.tech/api-reference/api-keys/list-api-keys.md): List all API keys for the authenticated user.
- [Show Api Key](https://docs.kathan.tech/api-reference/api-keys/show-api-key.md): Show the plaintext API key for the authenticated user.
- [Create Assistant](https://docs.kathan.tech/api-reference/assistants/create-assistant.md)
- [Delete Assistant](https://docs.kathan.tech/api-reference/assistants/delete-assistant.md)
- [Get Assistant](https://docs.kathan.tech/api-reference/assistants/get-assistant.md)
- [List Assistants](https://docs.kathan.tech/api-reference/assistants/list-assistants.md)
- [Update Assistant](https://docs.kathan.tech/api-reference/assistants/update-assistant.md)
- [Create Call](https://docs.kathan.tech/api-reference/calls/create-call.md)
- [Delete Call](https://docs.kathan.tech/api-reference/calls/delete-call.md)
- [Get Call](https://docs.kathan.tech/api-reference/calls/get-call.md)
- [List Calls](https://docs.kathan.tech/api-reference/calls/list-calls.md)
- [Update Call](https://docs.kathan.tech/api-reference/calls/update-call.md)
- [Add inline recipients](https://docs.kathan.tech/api-reference/campaigns/add-inline-recipients.md): Append recipients (phone numbers) to a campaign. Each recipient can include optional metadata (e.g. first_name for template variables) and assistant_overrides.
- [Create campaign](https://docs.kathan.tech/api-reference/campaigns/create-campaign.md)
- [Delete campaign](https://docs.kathan.tech/api-reference/campaigns/delete-campaign.md)
- [Get campaign](https://docs.kathan.tech/api-reference/campaigns/get-campaign.md)
- [List campaign recipients](https://docs.kathan.tech/api-reference/campaigns/list-campaign-recipients.md): List recipients (phone numbers) for a campaign with status, metadata, and last_error.
- [List campaigns](https://docs.kathan.tech/api-reference/campaigns/list-campaigns.md)
- [Pause campaign](https://docs.kathan.tech/api-reference/campaigns/pause-campaign.md): Pause the campaign. Valid when status is running. Returns campaign with updated status.
- [Purge expired data (cron)](https://docs.kathan.tech/api-reference/campaigns/purge-expired-data-cron.md): Purge campaign_recipients and campaign_call_logs for completed campaigns older than retention_days. Intended for cron/scheduled jobs.
- [Start campaign](https://docs.kathan.tech/api-reference/campaigns/start-campaign.md): Start the campaign. Valid when status is draft or paused. Returns campaign with updated status.
- [Update campaign (attach/detach list)](https://docs.kathan.tech/api-reference/campaigns/update-campaign-attachdetach-list.md)
- [Chat With Assistant](https://docs.kathan.tech/api-reference/chat/chat-with-assistant.md): Send a message to an assistant
- [Delete Chat](https://docs.kathan.tech/api-reference/chat/delete-chat.md): Delete a chat session and all its messages
- [Get Chat](https://docs.kathan.tech/api-reference/chat/get-chat.md): Get a specific chat session with all messages
- [List Chats](https://docs.kathan.tech/api-reference/chat/list-chats.md): List all chat sessions for the user
- [Get Balance](https://docs.kathan.tech/api-reference/credits/get-balance.md)
- [Get Ledger](https://docs.kathan.tech/api-reference/credits/get-ledger.md)
- [Get Usage](https://docs.kathan.tech/api-reference/credits/get-usage.md)
- [Redeem Promo Code](https://docs.kathan.tech/api-reference/credits/redeem-promo-code.md)
- [Health Check](https://docs.kathan.tech/api-reference/health-check.md): Health check endpoint
- [Create Knowledge Base From Pdf](https://docs.kathan.tech/api-reference/knowledge-bases/create-knowledge-base-from-pdf.md): Upload a PDF as a knowledge base (simple public API: file only). Attaching/detaching is done via Assistants API using `knowledge_base_id`.
- [Delete Knowledge Base](https://docs.kathan.tech/api-reference/knowledge-bases/delete-knowledge-base.md): Delete a KB (public endpoint). Best-effort deletes S3 assets referenced in metadata, then removes DB record. Note: DB attachments are cleaned up via FK `ON DELETE CASCADE`.
- [Get Knowledge Base](https://docs.kathan.tech/api-reference/knowledge-bases/get-knowledge-base.md): Get a single knowledge base (public-safe view).
- [List Knowledge Bases](https://docs.kathan.tech/api-reference/knowledge-bases/list-knowledge-bases.md): List all knowledge bases for the current user.
- [Update Knowledge Base Name](https://docs.kathan.tech/api-reference/knowledge-bases/update-knowledge-base-name.md): Update KB name (public).
- [Accept Invite](https://docs.kathan.tech/api-reference/organizations/accept-invite.md)
- [Create Invite](https://docs.kathan.tech/api-reference/organizations/create-invite.md)
- [Get My Organization](https://docs.kathan.tech/api-reference/organizations/get-my-organization.md): Return the current org resolved from JWT + X-Organization-ID.
- [List Members](https://docs.kathan.tech/api-reference/organizations/list-members.md)
- [List Orgs](https://docs.kathan.tech/api-reference/organizations/list-orgs.md)
- [Preview Invite](https://docs.kathan.tech/api-reference/organizations/preview-invite.md)
- [Remove Member](https://docs.kathan.tech/api-reference/organizations/remove-member.md)
- [Update Member Role](https://docs.kathan.tech/api-reference/organizations/update-member-role.md)
- [Create Phone Number](https://docs.kathan.tech/api-reference/phone-numbers/create-phone-number.md)
- [Delete Phone Number](https://docs.kathan.tech/api-reference/phone-numbers/delete-phone-number.md)
- [Get Phone Number](https://docs.kathan.tech/api-reference/phone-numbers/get-phone-number.md)
- [List Phone Numbers](https://docs.kathan.tech/api-reference/phone-numbers/list-phone-numbers.md)
- [Update Phone Number](https://docs.kathan.tech/api-reference/phone-numbers/update-phone-number.md)
- [Add single recipient](https://docs.kathan.tech/api-reference/recipient-lists/add-single-recipient.md): Add a single recipient to the list.
- [Create list (from CSV or empty)](https://docs.kathan.tech/api-reference/recipient-lists/create-list-from-csv-or-empty.md): Create a recipient list. Either from CSV upload or empty. - If file provided: parse CSV, create list with entries (no file storage). - If no file: create empty list.
- [Delete list](https://docs.kathan.tech/api-reference/recipient-lists/delete-list.md): Delete a recipient list and all its entries.
- [Download CSV template](https://docs.kathan.tech/api-reference/recipient-lists/download-csv-template.md): Download the standard CSV template for recipient lists. Columns: phone_number (required), name, metadata_1, metadata_2, metadata_3 (optional). Use this format when uploading CSV to ensure compatibility.
- [Export list as CSV](https://docs.kathan.tech/api-reference/recipient-lists/export-list-as-csv.md): Export a recipient list as CSV. Uses the standard template format.
- [Get list](https://docs.kathan.tech/api-reference/recipient-lists/get-list.md): Get a recipient list by ID.
- [List recipient lists](https://docs.kathan.tech/api-reference/recipient-lists/list-recipient-lists.md): List recipient lists for the user.
- [List recipients in list](https://docs.kathan.tech/api-reference/recipient-lists/list-recipients-in-list.md): List recipients in a list.
- [Remove recipient](https://docs.kathan.tech/api-reference/recipient-lists/remove-recipient.md): Remove a recipient from the list.
- [Update list name](https://docs.kathan.tech/api-reference/recipient-lists/update-list-name.md): Update recipient list (e.g. name).
- [Update recipient](https://docs.kathan.tech/api-reference/recipient-lists/update-recipient.md): Update a recipient in the list.
- [Upload CSV (replace or append)](https://docs.kathan.tech/api-reference/recipient-lists/upload-csv-replace-or-append.md): Upload CSV to add recipients to a list. - replace=True: replace all existing entries with CSV contents - replace=False: append CSV entries to existing list - use_template: if true, CSV must use template columns (phone_number, name, metadata_1, metadata_2, metadata_3)
- [Get Users Me](https://docs.kathan.tech/api-reference/users/get-users-me.md): Dashboard-friendly endpoint for current user + orgs.
- [Authentication](https://docs.kathan.tech/authentication.md): How to authenticate with the Kathan API
- [Api updates](https://docs.kathan.tech/changelog/api-updates.md): Stay updated with the latest features, improvements, and fixes in Kathan AI API.
- [Introduction](https://docs.kathan.tech/introduction.md): Welcome to Kathan API - Intelligence that just feels like human

## OpenAPI Specs

- [openapi](https://docs.kathan.tech/api-reference/openapi.json)