# co-mind.ai

## Docs

- [Audit Logs](https://docs.co-mind.ai/admin/audit-logs.md)
- [Directory Integration](https://docs.co-mind.ai/admin/directory.md)
- [Security Sanitizer](https://docs.co-mind.ai/admin/sanitizer.md)
- [Tenant Management](https://docs.co-mind.ai/admin/tenant-management.md)
- [Create API token](https://docs.co-mind.ai/api-reference/api-tokens/create-api-token.md): Create a new Personal Access Token (PAT) for programmatic API access. The token secret is returned only once in the response — store it securely. Token format: `cmnd_<tokenId>.<secret>` Maximum 25 active tokens per user. Maximum expiry: 365 days.
- [List API tokens](https://docs.co-mind.ai/api-reference/api-tokens/list-api-tokens.md): List all API tokens for the authenticated user. Token secrets are never returned.
- [List available token scopes](https://docs.co-mind.ai/api-reference/api-tokens/list-available-token-scopes.md): Get the list of available scopes for the authenticated user and whether they are an admin.
- [Revoke API token](https://docs.co-mind.ai/api-reference/api-tokens/revoke-api-token.md): Revoke (delete) an API token. This is idempotent.
- [Rotate API token](https://docs.co-mind.ai/api-reference/api-tokens/rotate-api-token.md): Revoke an existing token and create a new one with the same name and scopes. The new token secret is returned only once — store it securely. The old token is immediately invalidated.
- [Query audit logs](https://docs.co-mind.ai/api-reference/audit-logs/query-audit-logs.md): Query and aggregate audit logs. Admin role with auditView privilege required.
- [Change password](https://docs.co-mind.ai/api-reference/authentication/change-password.md): Change the authenticated user's password.
- [Check email registration](https://docs.co-mind.ai/api-reference/authentication/check-email-registration.md): Check whether an email address is already registered.
- [Confirm email](https://docs.co-mind.ai/api-reference/authentication/confirm-email.md): Confirm a user's email address using the verification code.
- [Get current user](https://docs.co-mind.ai/api-reference/authentication/get-current-user.md): Get the authenticated user's information.
- [Login](https://docs.co-mind.ai/api-reference/authentication/login.md): Authenticate with email and password to receive JWT access and refresh tokens.
- [Logout](https://docs.co-mind.ai/api-reference/authentication/logout.md): Revoke/blacklist access and refresh tokens.
- [Refresh access token](https://docs.co-mind.ai/api-reference/authentication/refresh-access-token.md): Get a new access token using a refresh token.
- [Register new user](https://docs.co-mind.ai/api-reference/authentication/register-new-user.md): Register a new user account with email, password, and name.
- [Request password reset](https://docs.co-mind.ai/api-reference/authentication/request-password-reset.md): Send a password reset email to the specified address.
- [Reset password](https://docs.co-mind.ai/api-reference/authentication/reset-password.md): Reset password using a token from the password reset email.
- [SSO login](https://docs.co-mind.ai/api-reference/authentication/sso-login.md): Authenticate via SSO using Microsoft Entra ID claims (oid, tid, upn).
- [Clear session history](https://docs.co-mind.ai/api-reference/chat/clear-session-history.md): Clear all messages from a chat session
- [Create chat completion](https://docs.co-mind.ai/api-reference/chat/create-chat-completion.md): OpenAI-compatible chat completions endpoint
- [Create chat session](https://docs.co-mind.ai/api-reference/chat/create-chat-session.md): Create a new chat session with server-managed conversation history
- [Delete chat session](https://docs.co-mind.ai/api-reference/chat/delete-chat-session.md): Delete a chat session and all its messages
- [Get chat session](https://docs.co-mind.ai/api-reference/chat/get-chat-session.md): Get details of a specific chat session
- [Get session message history](https://docs.co-mind.ai/api-reference/chat/get-session-message-history.md): Get conversation history for a chat session. Returns all messages in chronological order.
- [List chat sessions](https://docs.co-mind.ai/api-reference/chat/list-chat-sessions.md): Get all chat sessions for the authenticated user
- [Send message to session](https://docs.co-mind.ai/api-reference/chat/send-message-to-session.md): Send a message to a chat session (history managed by server)
- [Update chat session](https://docs.co-mind.ai/api-reference/chat/update-chat-session.md): Update session name or knowledgebase IDs
- [Create text completion](https://docs.co-mind.ai/api-reference/completions/create-text-completion.md): Legacy text completion endpoint
- [Create IDP config](https://docs.co-mind.ai/api-reference/directory-admin/create-idp-config.md): Create a new identity provider configuration. Admin role required.
- [Delete IDP config](https://docs.co-mind.ai/api-reference/directory-admin/delete-idp-config.md): Delete an identity provider configuration. Admin role required.
- [Get IDP config](https://docs.co-mind.ai/api-reference/directory-admin/get-idp-config.md): Get a specific identity provider configuration. Admin role required.
- [Get sync status](https://docs.co-mind.ai/api-reference/directory-admin/get-sync-status.md): Get the current sync status for a directory. Admin role required.
- [List IDP configs](https://docs.co-mind.ai/api-reference/directory-admin/list-idp-configs.md): List all identity provider (LDAP/AD) configurations. Admin role required.
- [Test directory connection](https://docs.co-mind.ai/api-reference/directory-admin/test-directory-connection.md): Test the connection to an LDAP/AD directory. Admin role required.
- [Trigger directory sync](https://docs.co-mind.ai/api-reference/directory-admin/trigger-directory-sync.md): Trigger a directory sync from LDAP/AD. Returns 202 with a jobId. Admin role required.
- [Update IDP config](https://docs.co-mind.ai/api-reference/directory-admin/update-idp-config.md): Update an identity provider configuration. Admin role required.
- [Check backend health](https://docs.co-mind.ai/api-reference/discovery/check-backend-health.md): Health check for all configured backends
- [Get capability matrix](https://docs.co-mind.ai/api-reference/discovery/get-capability-matrix.md): Get capability matrix for all backends
- [List available models](https://docs.co-mind.ai/api-reference/discovery/list-available-models.md): Get all available models across backends
- [List backend instances](https://docs.co-mind.ai/api-reference/discovery/list-backend-instances.md): Get all backend instances with their models and capabilities
- [Bulk resolve review items](https://docs.co-mind.ai/api-reference/document-analyzer/bulk-resolve-review-items.md): Resolve multiple review items at once in a document analysis session.
- [Complete review](https://docs.co-mind.ai/api-reference/document-analyzer/complete-review.md): Mark the review as complete for a document analysis session.
- [Create analysis session](https://docs.co-mind.ai/api-reference/document-analyzer/create-analysis-session.md): Create a new document analysis session.
- [Delete analysis session](https://docs.co-mind.ai/api-reference/document-analyzer/delete-analysis-session.md): Delete a document analysis session.
- [Download export](https://docs.co-mind.ai/api-reference/document-analyzer/download-export.md): Download session export using a one-time token (passed as query param).
- [Get analysis session](https://docs.co-mind.ai/api-reference/document-analyzer/get-analysis-session.md): Get details of a specific document analysis session.
- [Get export token](https://docs.co-mind.ai/api-reference/document-analyzer/get-export-token.md): Get a one-time export token for downloading session results.
- [Get review item](https://docs.co-mind.ai/api-reference/document-analyzer/get-review-item.md): Get a specific review item from a document analysis session.
- [Get review manifest](https://docs.co-mind.ai/api-reference/document-analyzer/get-review-manifest.md): Get the review manifest for a document analysis session.
- [Get session audit trail](https://docs.co-mind.ai/api-reference/document-analyzer/get-session-audit-trail.md): Get the audit trail for a document analysis session.
- [Get SSE token](https://docs.co-mind.ai/api-reference/document-analyzer/get-sse-token.md): Get a token for subscribing to server-sent events for a session.
- [List analysis sessions](https://docs.co-mind.ai/api-reference/document-analyzer/list-analysis-sessions.md): List all document analysis sessions for the authenticated user.
- [List candidates](https://docs.co-mind.ai/api-reference/document-analyzer/list-candidates.md): List extraction candidates for a document analysis session.
- [List rowsets](https://docs.co-mind.ai/api-reference/document-analyzer/list-rowsets.md): List rowsets for a document analysis session.
- [Resolve review item](https://docs.co-mind.ai/api-reference/document-analyzer/resolve-review-item.md): Resolve a specific review item in a document analysis session.
- [Update analysis session](https://docs.co-mind.ai/api-reference/document-analyzer/update-analysis-session.md): Update a document analysis session.
- [Update candidates](https://docs.co-mind.ai/api-reference/document-analyzer/update-candidates.md): Update extraction candidates for a document analysis session.
- [Update rowsets](https://docs.co-mind.ai/api-reference/document-analyzer/update-rowsets.md): Update rowsets for a document analysis session.
- [Upload document](https://docs.co-mind.ai/api-reference/document-analyzer/upload-document.md): Upload a document for analysis. Max file size 200MB. Timeout 300s.
- [Create a recording entry](https://docs.co-mind.ai/api-reference/echo-engine--recordings/create-a-recording-entry.md): Create a new recording entry in the database. Used before starting transcription.
- [Delete recording](https://docs.co-mind.ai/api-reference/echo-engine--recordings/delete-recording.md): Delete a recording by ID. Ownership verified.
- [Get recording by ID](https://docs.co-mind.ai/api-reference/echo-engine--recordings/get-recording-by-id.md): Retrieve a specific recording by its ID.
- [Link recording to transcription job](https://docs.co-mind.ai/api-reference/echo-engine--recordings/link-recording-to-transcription-job.md): Associate a recording with an async transcription job ID. Ownership verified.
- [List recordings](https://docs.co-mind.ai/api-reference/echo-engine--recordings/list-recordings.md): List recordings for the authenticated user.
- [Update recording](https://docs.co-mind.ai/api-reference/echo-engine--recordings/update-recording.md): Update recording metadata (title, KB link). Ownership verified.
- [List available TTS voices](https://docs.co-mind.ai/api-reference/echo-engine--tts/list-available-tts-voices.md): Retrieve list of available text-to-speech voices.
- [List TTS-supported languages](https://docs.co-mind.ai/api-reference/echo-engine--tts/list-tts-supported-languages.md): Retrieve list of languages supported for text-to-speech.
- [Synthesize text to speech](https://docs.co-mind.ai/api-reference/echo-engine--tts/synthesize-text-to-speech.md): Convert text to speech audio. Returns WAV audio. Supports prosody planning and conversational mode for voice agents. Max text length: 5000 characters.
- [Asynchronous audio transcription](https://docs.co-mind.ai/api-reference/echo-engine/asynchronous-audio-transcription.md): Upload an audio file for asynchronous transcription. Returns a job ID for status tracking via `GET /v1/echo/transcribe/{jobId}`.
- [Delete transcription job](https://docs.co-mind.ai/api-reference/echo-engine/delete-transcription-job.md): Delete an asynchronous transcription job and its results. Ownership verified.
- [Echo engine health check](https://docs.co-mind.ai/api-reference/echo-engine/echo-engine-health-check.md): Check if the echo engine (audio transcription service) is healthy and available.
- [Get echo engine metrics](https://docs.co-mind.ai/api-reference/echo-engine/get-echo-engine-metrics.md): Retrieve metrics and statistics from the echo engine.
- [Get supported transcription languages](https://docs.co-mind.ai/api-reference/echo-engine/get-supported-transcription-languages.md): Retrieve list of languages supported for audio transcription.
- [Get transcription job status](https://docs.co-mind.ai/api-reference/echo-engine/get-transcription-job-status.md): Retrieve the status and results of an asynchronous transcription job.
- [Synchronous audio transcription](https://docs.co-mind.ai/api-reference/echo-engine/synchronous-audio-transcription.md): Upload an audio file and receive transcription results synchronously. Supports speaker diarization. Max file size: 100 MB. Accepted formats: mp3, wav, m4a, flac, ogg, webm, wma, aac, opus.
- [Create embeddings](https://docs.co-mind.ai/api-reference/embeddings/create-embeddings.md): Generate text embeddings
- [Create Entra config](https://docs.co-mind.ai/api-reference/entra-admin/create-entra-config.md): Create a new Microsoft Entra ID configuration. Admin role required.
- [Delete Entra config](https://docs.co-mind.ai/api-reference/entra-admin/delete-entra-config.md): Delete a Microsoft Entra ID configuration. Admin role required.
- [Get Entra config](https://docs.co-mind.ai/api-reference/entra-admin/get-entra-config.md): Get a specific Microsoft Entra ID configuration. Admin role required.
- [List Entra configs](https://docs.co-mind.ai/api-reference/entra-admin/list-entra-configs.md): List all Microsoft Entra ID configurations. Admin role required.
- [Test Entra connection](https://docs.co-mind.ai/api-reference/entra-admin/test-entra-connection.md): Test the connection to Microsoft Entra ID. Admin role required.
- [Update Entra config](https://docs.co-mind.ai/api-reference/entra-admin/update-entra-config.md): Update a Microsoft Entra ID configuration. Admin role required.
- [API Reference](https://docs.co-mind.ai/api-reference/introduction.md)
- [Chat with knowledge bases](https://docs.co-mind.ai/api-reference/knowledge-base/chat-with-knowledge-bases.md): OpenAI-compatible chat endpoint with knowledge base RAG support (stateless)
- [Create knowledge base](https://docs.co-mind.ai/api-reference/knowledge-base/create-knowledge-base.md): Create a new knowledge base to store and chat with documents
- [Delete file from knowledge base](https://docs.co-mind.ai/api-reference/knowledge-base/delete-file-from-knowledge-base.md): Delete a specific file from a knowledge base
- [Delete knowledge base](https://docs.co-mind.ai/api-reference/knowledge-base/delete-knowledge-base.md): Delete a knowledge base and all its files
- [Get knowledge base](https://docs.co-mind.ai/api-reference/knowledge-base/get-knowledge-base.md): Get details of a specific knowledge base
- [List files in knowledge base](https://docs.co-mind.ai/api-reference/knowledge-base/list-files-in-knowledge-base.md): Get all files in a knowledge base
- [List knowledge bases](https://docs.co-mind.ai/api-reference/knowledge-base/list-knowledge-bases.md): Get all knowledge bases for the authenticated user
- [Query knowledge bases](https://docs.co-mind.ai/api-reference/knowledge-base/query-knowledge-bases.md): Query knowledge bases for relevant context without generating a chat response
- [Upload file to knowledge base](https://docs.co-mind.ai/api-reference/knowledge-base/upload-file-to-knowledge-base.md): Upload a file (PDF, DOCX, TXT, PNG, JPG, etc.) to a knowledge base
- [Health check](https://docs.co-mind.ai/api-reference/public/health-check.md): Check if the API is running
- [Get usage quota](https://docs.co-mind.ai/api-reference/quota/get-usage-quota.md): Get current usage quota information for the authenticated user.
- [Analyze content](https://docs.co-mind.ai/api-reference/researcher/analyze-content.md): Analyze provided content with a specified analysis type.
- [Create credibility config](https://docs.co-mind.ai/api-reference/researcher/create-credibility-config.md): Create a new credibility scoring configuration.
- [Critique research results](https://docs.co-mind.ai/api-reference/researcher/critique-research-results.md): Generate a critique of the research session results.
- [Delete credibility config](https://docs.co-mind.ai/api-reference/researcher/delete-credibility-config.md): Delete a credibility scoring configuration.
- [Delete research session](https://docs.co-mind.ai/api-reference/researcher/delete-research-session.md): Delete a research session.
- [Detailed researcher health](https://docs.co-mind.ai/api-reference/researcher/detailed-researcher-health.md): Get detailed health information for the researcher service.
- [Generate grant proposal](https://docs.co-mind.ai/api-reference/researcher/generate-grant-proposal.md): Generate a grant proposal from a research session.
- [Get credibility config](https://docs.co-mind.ai/api-reference/researcher/get-credibility-config.md): Get a specific credibility scoring configuration.
- [Get default credibility config](https://docs.co-mind.ai/api-reference/researcher/get-default-credibility-config.md): Get the default credibility scoring configuration.
- [Get full session data](https://docs.co-mind.ai/api-reference/researcher/get-full-session-data.md): Get full data for a research session including all iterations and sources.
- [Get research session status](https://docs.co-mind.ai/api-reference/researcher/get-research-session-status.md): Get the status of a research session.
- [Improve research results](https://docs.co-mind.ai/api-reference/researcher/improve-research-results.md): Improve the research session results based on critique feedback.
- [List credibility configs](https://docs.co-mind.ai/api-reference/researcher/list-credibility-configs.md): List all credibility scoring configurations.
- [List research sessions](https://docs.co-mind.ai/api-reference/researcher/list-research-sessions.md): List all research sessions for the authenticated user.
- [Pause research session](https://docs.co-mind.ai/api-reference/researcher/pause-research-session.md): Pause an active research session.
- [Ping researcher service](https://docs.co-mind.ai/api-reference/researcher/ping-researcher-service.md): Simple ping check for the researcher service.
- [Researcher health check](https://docs.co-mind.ai/api-reference/researcher/researcher-health-check.md): Check the health of the researcher service.
- [Resume research session](https://docs.co-mind.ai/api-reference/researcher/resume-research-session.md): Resume a paused research session.
- [Scrape URL](https://docs.co-mind.ai/api-reference/researcher/scrape-url.md): Scrape and extract content from a URL.
- [Set credibility config as default](https://docs.co-mind.ai/api-reference/researcher/set-credibility-config-as-default.md): Set a credibility scoring configuration as the default.
- [Start research session](https://docs.co-mind.ai/api-reference/researcher/start-research-session.md): Start an iterative research session on a topic. Timeout 600s.
- [Synthesize research](https://docs.co-mind.ai/api-reference/researcher/synthesize-research.md): Synthesize research session results into a specified format.
- [Update credibility config](https://docs.co-mind.ai/api-reference/researcher/update-credibility-config.md): Update a credibility scoring configuration.
- [Web search](https://docs.co-mind.ai/api-reference/researcher/web-search.md): Perform a web search query. Timeout 600s.
- [Get sanitizer policies](https://docs.co-mind.ai/api-reference/sanitizer-admin/get-sanitizer-policies.md): Returns current sanitizer policies for the tenant. Tenant isolation enforced.
- [Get sanitizer service health](https://docs.co-mind.ai/api-reference/sanitizer-admin/get-sanitizer-service-health.md): Returns the health status of the sanitizer service including model loading state.
- [Test sanitizer with sample text](https://docs.co-mind.ai/api-reference/sanitizer-admin/test-sanitizer-with-sample-text.md): Tests the sanitizer with sample text to see detection results for injection, jailbreak, and PII.
- [Update sanitizer policies](https://docs.co-mind.ai/api-reference/sanitizer-admin/update-sanitizer-policies.md): Update sanitizer policies for a tenant. Tenant isolation enforced. Accepts both JWT and service tokens (hybrid auth).
- [Discover tenant Entra config](https://docs.co-mind.ai/api-reference/service-endpoints/discover-tenant-entra-config.md): Get the tenant's Microsoft Entra ID SSO configuration (no secrets exposed).
- [PKCE token exchange](https://docs.co-mind.ai/api-reference/service-endpoints/pkce-token-exchange.md): Exchange an authorization code for tokens using PKCE flow.
- [Refresh service token](https://docs.co-mind.ai/api-reference/service-endpoints/refresh-service-token.md): Refresh a token using a refresh token. Accepts JWT, PAT, or service tokens (hybrid auth).
- [Create sub-organization](https://docs.co-mind.ai/api-reference/sub-org-management/create-sub-organization.md): Create a new sub-organization within a tenant. Admin role required.
- [Delete sub-organization](https://docs.co-mind.ai/api-reference/sub-org-management/delete-sub-organization.md): Delete a sub-organization. Admin role required.
- [Get sub-organization](https://docs.co-mind.ai/api-reference/sub-org-management/get-sub-organization.md): Get a specific sub-organization. Admin role required.
- [List sub-organizations](https://docs.co-mind.ai/api-reference/sub-org-management/list-sub-organizations.md): List sub-organizations within a tenant. Admin role required.
- [Update sub-organization](https://docs.co-mind.ai/api-reference/sub-org-management/update-sub-organization.md): Update a sub-organization. Admin role required.
- [Add user to tenant](https://docs.co-mind.ai/api-reference/tenant-admin/add-user-to-tenant.md): Add an existing user to a tenant. Admin or SysAdmin role required.
- [Create tenant](https://docs.co-mind.ai/api-reference/tenant-admin/create-tenant.md): Create a new tenant. Admin or SysAdmin role required.
- [Create user](https://docs.co-mind.ai/api-reference/tenant-admin/create-user.md): Create a new user account. Admin or SysAdmin role required.
- [Delete tenant](https://docs.co-mind.ai/api-reference/tenant-admin/delete-tenant.md): Delete a tenant. SysAdmin role required.
- [Get tenant](https://docs.co-mind.ai/api-reference/tenant-admin/get-tenant.md): Get a specific tenant. Admin or SysAdmin role required.
- [Get tenant usage](https://docs.co-mind.ai/api-reference/tenant-admin/get-tenant-usage.md): Get usage statistics for a tenant. Admin or SysAdmin role required.
- [List tenant users](https://docs.co-mind.ai/api-reference/tenant-admin/list-tenant-users.md): List all users in a tenant. Admin or SysAdmin role required.
- [List tenants](https://docs.co-mind.ai/api-reference/tenant-admin/list-tenants.md): List all tenants. Admin or SysAdmin role required.
- [Remove user from tenant](https://docs.co-mind.ai/api-reference/tenant-admin/remove-user-from-tenant.md): Remove a user from a tenant. Admin or SysAdmin role required.
- [Update tenant](https://docs.co-mind.ai/api-reference/tenant-admin/update-tenant.md): Update a tenant. Admin or SysAdmin role required.
- [Update user role](https://docs.co-mind.ai/api-reference/tenant-admin/update-user-role.md): Update a user's role in a tenant. Admin or SysAdmin role required.
- [Create tenant API key](https://docs.co-mind.ai/api-reference/tenant-api-keys/create-tenant-api-key.md): Create a provider API key for a tenant. Admin role required.
- [Delete tenant API key](https://docs.co-mind.ai/api-reference/tenant-api-keys/delete-tenant-api-key.md): Delete a provider API key from a tenant. Admin role required.
- [List tenant API keys](https://docs.co-mind.ai/api-reference/tenant-api-keys/list-tenant-api-keys.md): List provider API keys for a tenant. Admin role required.
- [Release Notes](https://docs.co-mind.ai/changelog/release-notes.md)
- [API Tokens](https://docs.co-mind.ai/guides/api-tokens.md)
- [Authentication](https://docs.co-mind.ai/guides/authentication.md)
- [Developer Guide](https://docs.co-mind.ai/guides/developer-guide.md)
- [Installation](https://docs.co-mind.ai/guides/installation.md): Step-by-step guide to install and configure the co-mind.ai platform on your own infrastructure.
- [Postman Collection](https://docs.co-mind.ai/guides/postman.md)
- [Quickstart](https://docs.co-mind.ai/guides/quickstart.md)
- [n8n Integration](https://docs.co-mind.ai/integrations/n8n.md)
- [Overview](https://docs.co-mind.ai/platform/overview.md)

## OpenAPI Specs

- [openapi](https://docs.co-mind.ai/openapi.yaml)