API Introduction

Integrate Odeus's powerful AI capabilities into your applications with our comprehensive API suite

Overview

The Odeus API provides programmatic access to state-of-the-art AI models while maintaining enterprise-grade security and compliance. Whether you're building custom applications, automating workflows, or enhancing existing systems, our API offers the flexibility and power you need.

Available APIs

Completion API

Access leading language models from OpenAI, Anthropic, Mistral, and Google for text generation, analysis, and reasoning tasks.

• OpenAI API - GPT and reasoning models
• Anthropic API - Claude models
• Google API - Gemini models
• Mistral API - Mistral models

Embedding API

Generate high-quality embeddings for semantic search, similarity matching, and RAG applications.

• OpenAI Embeddings - Text embeddings for various use cases

Agent API

Create and manage custom AI agents programmatically with specialized knowledge and capabilities.

• Agent API Guide - Complete guide to using agents
• Managing Agents - Create and configure agents
• Agent Models - Available models for agents
• Upload Attachments - Add documents to agents

Knowledge Folder API

Manage your organization's knowledge base programmatically for RAG and document processing.

• Sharing - Share knowledge folders
• Upload Files - Add documents
• Search - Search within folders

Integrations API

Create and manage custom integrations with external services programmatically.

• Integrations Overview - Complete guide to integrations API

Usage Export API

Export usage data for analytics, billing, and compliance reporting.

• Usage Export Guide - Export users, agents, models, and project data

User Management API

Programmatically manage workspace users, including automated invitation flows.

• Invite Users - Invite users to your workspace via email

Getting Started

Base URL

For standard Odeus Cloud users, use the following base URL for all API requests:

```
https://api.odeus.ai
```



If your organization uses a dedicated Odeus deployment (custom domain), your base URL follows this pattern:

```
https://<your-domain>/api/public
```

For example, if your Odeus instance is at `https://odeus.yourcompany.com`, the API base URL would be:

```
https://odeus.yourcompany.com/api/public
```

> **Common mistake:** Don't forget the `/api/public` prefix when using a dedicated deployment. Using just your domain without this prefix will result in authentication errors or redirects.

Authentication

All API requests require authentication using a Bearer token:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.odeus.ai/openai/eu/v1/chat/completions

Security Note:

Odeus intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. Calling the API from the browser (e.g., from JavaScript running in a web page) exposes the Odeus API Key publicly and creates a security risk. Therefore, the Odeus API must be accessed from a secure backend environment. For more information, please see our guide on API Key Best Practices.

Rate Limits

API requests are subject to rate limiting to ensure fair usage and system stability. Rate limits are applied per model. The default limits are 500 RPM (requests per minute) and 60,000 TPM (tokens per minute). If you consistently hit these limits, reach out to our support team to discuss an increase in rate limits.

For BYOK workspaces, admins can configure custom limits per model in Settings > Models.

Key Features

• GDPR Compliant — All API operations maintain full GDPR compliance with data processing in EU regions

• Multiple Models — Access models from OpenAI, Anthropic, Mistral, and more through a unified interface

• Enterprise Security — SOC 2 certified infrastructure with end-to-end encryption and audit logging

• BYOK Support — Bring Your Own Key (BYOK) option for enhanced control over API access

Use Cases

• Custom Applications: Build AI-powered features into your applications
• Workflow Automation: Automate document processing and analysis
• Data Analysis: Extract insights from large volumes of text data
• Content Generation: Create high-quality content at scale
• Semantic Search: Implement intelligent search across your knowledge base

Support

For API support and questions reach out to us at [email protected].