# LumenOne's API Docs

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.lumenia.net/_mcp/server

## Docs

- [Introduction](https://docs.lumenia.net/documentation/get-started/introduction.md): Programmatic access to your LumenOne instance.
- [Authentication](https://docs.lumenia.net/documentation/get-started/authentication.md): API keys, account context, and how to obtain credentials.
- [General concepts](https://docs.lumenia.net/documentation/get-started/concepts.md): The partner/account/org/workspace hierarchy, opaque ids, folders, and embedding.
- [Quickstart](https://docs.lumenia.net/documentation/get-started/quickstart.md): From zero to a live assistant your customers can call or message.
- [Errors](https://docs.lumenia.net/documentation/get-started/errors.md): Common failure modes and how to fix them.
- [Partner](https://docs.lumenia.net/documentation/core-concepts/partner.md): Your company — the top-level principal behind the API key.
- [Accounts](https://docs.lumenia.net/documentation/core-concepts/accounts.md): A customer container under your company — and the value behind X-Account-Id.
- [Organizations](https://docs.lumenia.net/documentation/core-concepts/organizations.md): The tenant boundary that owns workspaces, documents, and tools.
- [Workspaces](https://docs.lumenia.net/documentation/core-concepts/workspaces.md): An isolated chat/RAG environment with its own settings, knowledge, tools, and channels.
- [Documents & knowledge base](https://docs.lumenia.net/documentation/core-concepts/documents.md): Upload once per organization, embed into any workspace, and understand what deletion does.
- [Tools](https://docs.lumenia.net/documentation/core-concepts/tools.md): Reusable HTTP actions an assistant can call mid-conversation — and how to drive them from the prompt.
- [Prompt templates](https://docs.lumenia.net/documentation/core-concepts/prompt-templates.md): Partner-owned, versioned prompts you write once and roll out to many workspaces.
- [Voice integration & routing numbers](https://docs.lumenia.net/documentation/core-concepts/voice-integration.md): Turn a workspace into a phone assistant, and understand the routing-number pool behind it.
- [Call logs](https://docs.lumenia.net/documentation/core-concepts/call-logs.md): Read-only records of the voice calls your assistants handled.
- [WhatsApp integration](https://docs.lumenia.net/documentation/core-concepts/whatsapp-integration.md): Connect a workspace to WhatsApp Business so it answers WhatsApp messages.
- [Telegram integration](https://docs.lumenia.net/documentation/core-concepts/telegram-integration.md): Connect a workspace to a Telegram bot so it answers Telegram messages.

## API Docs

- API Reference > Authentication [Identify the caller](https://docs.lumenia.net/api-reference/authentication/identify-the-caller.md)
- API Reference > Accounts [List accounts](https://docs.lumenia.net/api-reference/accounts/list-accounts.md)
- API Reference > Accounts [Create account](https://docs.lumenia.net/api-reference/accounts/create-account.md)
- API Reference > Accounts [Get account](https://docs.lumenia.net/api-reference/accounts/get-account.md)
- API Reference > Accounts [Delete account](https://docs.lumenia.net/api-reference/accounts/delete-account.md)
- API Reference > Accounts [Update account](https://docs.lumenia.net/api-reference/accounts/update-account.md)
- API Reference > Organizations [List organizations](https://docs.lumenia.net/api-reference/organizations/list-organizations.md)
- API Reference > Organizations [Create organization](https://docs.lumenia.net/api-reference/organizations/create-organization.md)
- API Reference > Organizations [Get organization](https://docs.lumenia.net/api-reference/organizations/get-organization.md)
- API Reference > Organizations [Delete organization](https://docs.lumenia.net/api-reference/organizations/delete-organization.md)
- API Reference > Organizations [Update organization](https://docs.lumenia.net/api-reference/organizations/update-organization.md)
- API Reference > Workspaces [List workspaces](https://docs.lumenia.net/api-reference/workspaces/list-workspaces.md)
- API Reference > Workspaces [Create workspace](https://docs.lumenia.net/api-reference/workspaces/create-workspace.md)
- API Reference > Workspaces [Get workspace](https://docs.lumenia.net/api-reference/workspaces/get-workspace.md)
- API Reference > Workspaces [Delete workspace](https://docs.lumenia.net/api-reference/workspaces/delete-workspace.md)
- API Reference > Workspaces [Update workspace](https://docs.lumenia.net/api-reference/workspaces/update-workspace.md)
- API Reference > Workspaces [Get workspace logo](https://docs.lumenia.net/api-reference/workspaces/get-workspace-logo.md)
- API Reference > Workspaces [Upload workspace logo](https://docs.lumenia.net/api-reference/workspaces/upload-workspace-logo.md)
- API Reference > Workspaces [Remove workspace logo](https://docs.lumenia.net/api-reference/workspaces/remove-workspace-logo.md)
- API Reference > Documents [List organization documents](https://docs.lumenia.net/api-reference/documents/list-organization-documents.md)
- API Reference > Documents [Upload an organization document](https://docs.lumenia.net/api-reference/documents/upload-an-organization-document.md)
- API Reference > Documents [Get an organization document](https://docs.lumenia.net/api-reference/documents/get-an-organization-document.md)
- API Reference > Documents [Delete an organization document](https://docs.lumenia.net/api-reference/documents/delete-an-organization-document.md)
- API Reference > Documents [Move a document to another folder](https://docs.lumenia.net/api-reference/documents/move-a-document-to-another-folder.md)
- API Reference > Documents [List organization folders](https://docs.lumenia.net/api-reference/documents/list-organization-folders.md)
- API Reference > Documents [Create a folder](https://docs.lumenia.net/api-reference/documents/create-a-folder.md)
- API Reference > Documents [Delete a folder](https://docs.lumenia.net/api-reference/documents/delete-a-folder.md)
- API Reference > Tools [List organization tools](https://docs.lumenia.net/api-reference/tools/list-organization-tools.md)
- API Reference > Tools [Create organization tool](https://docs.lumenia.net/api-reference/tools/create-organization-tool.md)
- API Reference > Tools [List partner tools](https://docs.lumenia.net/api-reference/tools/list-partner-tools.md)
- API Reference > Tools [Create partner tool](https://docs.lumenia.net/api-reference/tools/create-partner-tool.md)
- API Reference > Tools [Get tool](https://docs.lumenia.net/api-reference/tools/get-tool.md)
- API Reference > Tools [Delete tool](https://docs.lumenia.net/api-reference/tools/delete-tool.md)
- API Reference > Tools [Update tool](https://docs.lumenia.net/api-reference/tools/update-tool.md)
- API Reference > Prompt Templates [List prompt templates](https://docs.lumenia.net/api-reference/prompt-templates/list-prompt-templates.md)
- API Reference > Prompt Templates [Create prompt template](https://docs.lumenia.net/api-reference/prompt-templates/create-prompt-template.md)
- API Reference > Prompt Templates [Get prompt template](https://docs.lumenia.net/api-reference/prompt-templates/get-prompt-template.md)
- API Reference > Prompt Templates [Delete prompt template](https://docs.lumenia.net/api-reference/prompt-templates/delete-prompt-template.md)
- API Reference > Prompt Templates [Update prompt template](https://docs.lumenia.net/api-reference/prompt-templates/update-prompt-template.md)
- API Reference > Prompt Template Versions [List template versions](https://docs.lumenia.net/api-reference/prompt-template-versions/list-template-versions.md)
- API Reference > Prompt Template Versions [Create template version](https://docs.lumenia.net/api-reference/prompt-template-versions/create-template-version.md)
- API Reference > Prompt Template Versions [Get template version](https://docs.lumenia.net/api-reference/prompt-template-versions/get-template-version.md)
- API Reference > Prompt Template Versions [Update template version (draft only)](https://docs.lumenia.net/api-reference/prompt-template-versions/update-template-version-draft-only.md)
- API Reference > Prompt Template Versions [Publish template version](https://docs.lumenia.net/api-reference/prompt-template-versions/publish-template-version.md)
- API Reference > Prompt Template Versions [Archive template version](https://docs.lumenia.net/api-reference/prompt-template-versions/archive-template-version.md)
- API Reference > Workspace Tools [List workspace tools](https://docs.lumenia.net/api-reference/workspace-tools/list-workspace-tools.md)
- API Reference > Workspace Tools [Get effective workspace tools](https://docs.lumenia.net/api-reference/workspace-tools/get-effective-workspace-tools.md)
- API Reference > Workspace Tools [Attach tool to workspace](https://docs.lumenia.net/api-reference/workspace-tools/attach-tool-to-workspace.md)
- API Reference > Workspace Tools [Detach tool from workspace](https://docs.lumenia.net/api-reference/workspace-tools/detach-tool-from-workspace.md)
- API Reference > Workspace Prompt Templates [Assign prompt template](https://docs.lumenia.net/api-reference/workspace-prompt-templates/assign-prompt-template.md)
- API Reference > Workspace Prompt Templates [Unassign prompt template](https://docs.lumenia.net/api-reference/workspace-prompt-templates/unassign-prompt-template.md)
- API Reference > Workspace Prompt Templates [Update assignment variables](https://docs.lumenia.net/api-reference/workspace-prompt-templates/update-assignment-variables.md)
- API Reference > Workspace Documents [List workspace documents](https://docs.lumenia.net/api-reference/workspace-documents/list-workspace-documents.md)
- API Reference > Workspace Documents [Embed a document into a workspace](https://docs.lumenia.net/api-reference/workspace-documents/embed-a-document-into-a-workspace.md)
- API Reference > Workspace Documents [Remove an embedded document from a workspace](https://docs.lumenia.net/api-reference/workspace-documents/remove-an-embedded-document-from-a-workspace.md)
- API Reference > Workspace Voice [Get workspace voice integration](https://docs.lumenia.net/api-reference/workspace-voice/get-workspace-voice-integration.md)
- API Reference > Workspace Voice [Create workspace voice integration](https://docs.lumenia.net/api-reference/workspace-voice/create-workspace-voice-integration.md)
- API Reference > Workspace Voice [Remove workspace voice integration](https://docs.lumenia.net/api-reference/workspace-voice/remove-workspace-voice-integration.md)
- API Reference > Workspace Voice [Update workspace voice integration](https://docs.lumenia.net/api-reference/workspace-voice/update-workspace-voice-integration.md)
- API Reference > Workspace Voice [Get voice integration options](https://docs.lumenia.net/api-reference/workspace-voice/get-voice-integration-options.md)
- API Reference > Workspace Whats App [Get workspace WhatsApp integration](https://docs.lumenia.net/api-reference/workspace-whats-app/get-workspace-whats-app-integration.md)
- API Reference > Workspace Whats App [Disconnect workspace WhatsApp integration](https://docs.lumenia.net/api-reference/workspace-whats-app/disconnect-workspace-whats-app-integration.md)
- API Reference > Workspace Whats App [List workspace WhatsApp phone numbers](https://docs.lumenia.net/api-reference/workspace-whats-app/list-workspace-whats-app-phone-numbers.md)
- API Reference > Workspace Whats App [Register a WhatsApp phone number](https://docs.lumenia.net/api-reference/workspace-whats-app/register-a-whats-app-phone-number.md)
- API Reference > Workspace Whats App [Create WhatsApp signup URL](https://docs.lumenia.net/api-reference/workspace-whats-app/create-whats-app-signup-url.md)
- API Reference > Workspace Whats App [Render WhatsApp signup page](https://docs.lumenia.net/api-reference/workspace-whats-app/render-whats-app-signup-page.md)
- API Reference > Workspace Telegram [Get workspace Telegram integration](https://docs.lumenia.net/api-reference/workspace-telegram/get-workspace-telegram-integration.md)
- API Reference > Workspace Telegram [Connect workspace Telegram integration](https://docs.lumenia.net/api-reference/workspace-telegram/connect-workspace-telegram-integration.md)
- API Reference > Workspace Telegram [Disconnect workspace Telegram integration](https://docs.lumenia.net/api-reference/workspace-telegram/disconnect-workspace-telegram-integration.md)
- API Reference > Call Logs [List call logs](https://docs.lumenia.net/api-reference/call-logs/list-call-logs.md)
- API Reference > Call Logs [Get call log](https://docs.lumenia.net/api-reference/call-logs/get-call-log.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.lumenia.net/openapi.json)
- [OpenAPI YAML](https://docs.lumenia.net/openapi.yaml)