Skip to content
ajan.io

Docs menu

On this page

API Introduction

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

Overview

The ajan 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.

Embedding API

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

Agent API

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

Knowledge Folder API

Manage Knowledge bases programmatically for RAG and document processing. These resources appear as Knowledge bases in the Library.

Prompt Library API

Create, update, and manage prompts and prompt folders programmatically. Requests require an API key with the PROMPT_API scope.

Integrations API

Create and manage custom integrations with external services programmatically.

Skills API

Create, import, update, and manage reusable Skills programmatically. Requests require an API key with the SKILL_API scope.

Usage Export API

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

Workflow Run Export API

Export workflow run and node execution data as JSON for analysis and debugging.

User Management API

Programmatically invite users, change an active member's system role, and deactivate members.

Audit Logs API

Retrieve a record of workspace activity for security monitoring and compliance.

Getting Started

Base URL

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

    https://api.ajan.io

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

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

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

    https://ajan.yourcompany.com/api/public

Authentication

All API requests require authentication using a Bearer token:

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.ajan.io/openai/eu/v1/chat/completions

Create a personal API key for completion requests under your own identity, or ask a workspace admin for a workspace API key with the scopes your integration needs.

Security Note:

Rate Limits

API requests are subject to rate limiting to ensure fair usage and system stability. The default limits are 500 RPM (requests per minute) and 150,000 TPM (tokens per minute). RPM is enforced per workspace, model, and API key. TPM is shared by all API keys using the same model in a workspace. Workspace admins who are not on BYOK can request higher limits from Model quotas in Settings > Workspace > Products > API. On dedicated deployments, admins can also set custom limits per model in the same API settings. See Workspace Settings.

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
  • Cookbook — Self-contained, runnable recipes for building on ajan

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 support@ajan.com.