# Kai

> Kai turns your chat history into your best support rep.

## Docs

- [Archive a workspace attribute](https://docs.kaisupport.com/api-reference/attributes/archive-a-workspace-attribute.md): Archives the attribute. Kai keeps every value that contacts already hold for it, and refuses new writes to it.
- [Create or update a workspace attribute](https://docs.kaisupport.com/api-reference/attributes/create-or-update-a-workspace-attribute.md): Creates the attribute, or updates the label, description, options and position of an attribute that exists.
- [List workspace attributes](https://docs.kaisupport.com/api-reference/attributes/list-workspace-attributes.md): Returns every attribute, including the archived ones.
- [Clear the account owner](https://docs.kaisupport.com/api-reference/contacts/clear-the-account-owner.md): The contact returns to the shared pool. Open conversations do not move.
- [Create or update a contact](https://docs.kaisupport.com/api-reference/contacts/create-or-update-a-contact.md): Matches the contact by identity, then creates it or updates it.
- [Delete a contact](https://docs.kaisupport.com/api-reference/contacts/delete-a-contact.md): Deletes the profile. The conversations of this customer stay in the inbox, and they lose their link to the profile.
- [List contacts](https://docs.kaisupport.com/api-reference/contacts/list-contacts.md): Returns one page of contacts, oldest change first.
- [Read a contact](https://docs.kaisupport.com/api-reference/contacts/read-a-contact.md)
- [Set the account owner](https://docs.kaisupport.com/api-reference/contacts/set-the-account-owner.md): Gives the account to one teammate. New conversations from this customer go to that teammate.
- [Update a contact](https://docs.kaisupport.com/api-reference/contacts/update-a-contact.md): Updates the contact with this id. Kai never creates a contact here. If the id does not exist, the response is 404.
- [Write many contacts in one request](https://docs.kaisupport.com/api-reference/contacts/write-many-contacts-in-one-request.md): Runs up to 1000 operations. Each operation answers for itself.
- [List workspace members](https://docs.kaisupport.com/api-reference/members/list-workspace-members.md): Returns the teammates of this workspace. Use it to map the email addresses in your own system to Kai member ids before you assign account owners.
- [Authentication](https://docs.kaisupport.com/authentication.md): API keys, permissions and the rules that apply to them.
- [Account owners](https://docs.kaisupport.com/concepts/account-owners.md): Give a customer to a teammate, and route their conversations to that person.
- [Workspace attributes](https://docs.kaisupport.com/concepts/attributes.md): The fields that your workspace keeps on every contact.
- [Contacts](https://docs.kaisupport.com/concepts/contacts.md): What a contact holds, where it comes from, and how a write changes it.
- [Identity](https://docs.kaisupport.com/concepts/identity.md): How Kai decides which contact a write belongs to.
- [Kai Contacts API](https://docs.kaisupport.com/contacts-api/overview.md): Push, update, assign and export the contacts of your Kai workspace.
- [Sync account owners](https://docs.kaisupport.com/guides/assignments.md): Push a book of business from your CRM into Kai.
- [Import many contacts](https://docs.kaisupport.com/guides/bulk-import.md): Load thousands of contacts with the batch endpoint.
- [Errors](https://docs.kaisupport.com/guides/errors.md): The error shape, every error type, and what to do about each one.
- [Export contacts](https://docs.kaisupport.com/guides/export.md): Read every contact, or only the contacts that changed.
- [What Kai is](https://docs.kaisupport.com/index.md): Kai reads the conversations your team already handled, and turns them into a support agent that drafts or replies.
- [Ask Kai a question](https://docs.kaisupport.com/product/agent/ask-kai.md): Find your team's answer to a question, with its sources, before you write to a customer.
- [Close and reopen a conversation](https://docs.kaisupport.com/product/agent/close-and-reopen.md): Finish a conversation, find it again, and reply after the WhatsApp 24 hour window closes.
- [Find your work](https://docs.kaisupport.com/product/agent/find-your-work.md): Find the conversations that are yours, the ones nobody holds, and a customer you remember by name.
- [Kai for support agents](https://docs.kaisupport.com/product/agent/index.md): What Kai does in your inbox, what it never does, and what you decide.
- [Rate what Kai writes](https://docs.kaisupport.com/product/agent/rate-what-kai-writes.md): Why an unrated reply teaches nothing, and how to leave a rating or a correction that does.
- [Send a Kai draft](https://docs.kaisupport.com/product/agent/send-a-kai-draft.md): Read a draft, check it in ten seconds, edit it, and send it as your own reply.
- [Take and hand over a conversation](https://docs.kaisupport.com/product/agent/take-and-hand-over.md): Take a conversation nobody holds, give one to a teammate, and see who is on it.
- [Best practices](https://docs.kaisupport.com/product/best-practices.md): Ten rules for the first weeks with Kai, and the reason behind each one.
- [Channels](https://docs.kaisupport.com/product/channels.md): Connect Intercom or WhatsApp Cloud, set a mode per source, and keep WhatsApp templates in order.
- [The console](https://docs.kaisupport.com/product/console.md): Four modes: ask the Brain, propose a change, test the real reply path, and review what Kai said.
- [Contacts and account owners](https://docs.kaisupport.com/product/contacts.md): The customer record behind every conversation, and the teammate who owns the account.
- [Current information](https://docs.kaisupport.com/product/current-information.md): Prices, links and payment details live outside the Brain version, so a change takes effect on the next reply.
- [The overview page](https://docs.kaisupport.com/product/dashboard.md): Read every card on the Overview page, and know what to do when a number is wrong.
- [Working with Kai's drafts](https://docs.kaisupport.com/product/drafts.md): Use a draft, edit it before you send it, and rate it so the next retrain learns from it.
- [Get started](https://docs.kaisupport.com/product/getting-started.md): From sign-up to Kai's first draft in your inbox, with what good looks like at each step.
- [Glossary](https://docs.kaisupport.com/product/glossary.md): Every term Kai uses, in one short definition each.
- [How Kai works](https://docs.kaisupport.com/product/how-it-works.md): The pipeline from a chat export to a live reply, and the rules that decide what Kai may send.
- [The inbox](https://docs.kaisupport.com/product/inbox.md): Read the queue, reply to a customer, assign a conversation, and close it.
- [The knowledge base](https://docs.kaisupport.com/product/knowledge-base.md): What a Brain holds, what each of the six categories controls, and what the four review states mean.
- [Copilot, autopilot and off](https://docs.kaisupport.com/product/modes.md): What each mode does, what Kai will not send even on autopilot, and a safe order to turn things on.
- [Retrain the Brain](https://docs.kaisupport.com/product/retrain.md): Compile a new draft from newer conversations and your team's review decisions, without changing anything for customers.
- [Review and publish](https://docs.kaisupport.com/product/review-and-publish.md): Work the review queue, decide on each item, and take a Brain version live.
- [People and permissions](https://docs.kaisupport.com/product/team.md): The three roles in a Kai workspace, what each one may do, and where a role is assigned.
- [Attributes, API keys and data controls](https://docs.kaisupport.com/product/workspace-data.md): Define what your workspace keeps on a contact, hand a key to your own systems, and erase raw uploads.
- [Quickstart](https://docs.kaisupport.com/quickstart.md): Make an API key, create an attribute, and push your first contact.

## OpenAPI Specs

- [openapi](https://docs.kaisupport.com/openapi.yaml)