# miniDesk.ai

- [miniDesk.ai](https://docs.minidesk.ai/index.md): One shared inbox for every customer question, from chat, forms and email. AI drafts the replies.
- [Quickstart](https://docs.minidesk.ai/quickstart.md): Get a key, open a ticket, and read the reply. Around five minutes.
- [Authentication](https://docs.minidesk.ai/guides/authentication.md): Bearer credentials, issued per workspace and revocable per request.
- [Errors](https://docs.minidesk.ai/guides/errors.md): One envelope on every surface, and a closed set of codes to branch on.
- [Pagination](https://docs.minidesk.ai/guides/pagination.md): Cursor based, because a support queue moves while you read it.
- [Rate limits](https://docs.minidesk.ai/guides/rate-limits.md): 600 a minute per credential, with a 60 a second burst ceiling.
- [Idempotency](https://docs.minidesk.ai/guides/idempotency.md): Make a retried POST safe, with a 24 hour replay window.
- [Quotas](https://docs.minidesk.ai/guides/quotas.md): What stops when a workspace runs out of conversations, and what carries on.
- [Channels](https://docs.minidesk.ai/channels/overview.md): How you and your customers talk to each other. Everything lands in one inbox.
- [Chat on your website](https://docs.minidesk.ai/channels/chat-widget.md): One script tag, on any site.
- [Contact form](https://docs.minidesk.ai/channels/contact-form.md): A card that renders inside your own contact page.
- [Email](https://docs.minidesk.ai/channels/email.md): Forward your existing support address. No code, no DNS changes.
- [MCP server](https://docs.minidesk.ai/mcp/overview.md): Let an AI agent read your support queue and draft replies.
- [Tools](https://docs.minidesk.ai/mcp/tools.md): The seven tools, what they take, and what they return.
- [What an agent cannot do](https://docs.minidesk.ai/mcp/safety.md): Why there is no send tool, and why that is stronger than a permission.
- [Claude](https://docs.minidesk.ai/mcp/connect/claude.md): Connect miniDesk to Claude Desktop, claude.ai, or Claude Code.
- [ChatGPT](https://docs.minidesk.ai/mcp/connect/chatgpt.md): Connect miniDesk to ChatGPT as a custom connector.
- [Cursor](https://docs.minidesk.ai/mcp/connect/cursor.md): Connect miniDesk to Cursor and other editors.
- [Any other client](https://docs.minidesk.ai/mcp/connect/custom.md): The raw protocol, for building your own agent.
- [Introduction](https://docs.minidesk.ai/api-reference/introduction.md): The versioned REST API for reading and working tickets.
- [List tickets](https://docs.minidesk.ai/api-reference/tickets/list-tickets.md): Newest first, cursor paginated. A queue mutates while you page through it, so offsets would skip or repeat rows.
- [Create a ticket](https://docs.minidesk.ai/api-reference/tickets/create-a-ticket.md): Opens a conversation. There is no subject: a ticket is described by its first message.
- [Get a ticket](https://docs.minidesk.ai/api-reference/tickets/get-a-ticket.md): The ticket and its **public** messages. Internal notes are never included on this surface, on any parameter.
- [Update a ticket](https://docs.minidesk.ai/api-reference/tickets/update-a-ticket.md): Change status, priority, category or assignee. Send at least one field.
- [List messages](https://docs.minidesk.ai/api-reference/messages/list-messages.md): Public messages only, oldest first.
- [Reply to a ticket](https://docs.minidesk.ai/api-reference/messages/reply-to-a-ticket.md): A `public` message reaches the requester through whichever channel the ticket arrived on. An `internal` note notifies nobody outside the workspace and is never returned by the read endpoints.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

- [Support](mailto:hello@minidesk.ai)