API Documentation

Comprehensive REST API with 110+ endpoints for content management, AI services, and more. Built with FastAPI, featuring automatic OpenAPI documentation and interactive testing.

110+ Endpoints

JWT Authentication

AI-Powered

OpenAPI 3.1

Interactive API Docs (Swagger)Download OpenAPI Spec

Quick Start

Get started with the Cognitor CMS API in minutes

1. Authentication

# Login to get JWT token

POST

https://backend.cognitor.dev/auth/login

{ "username": "user@example.com", "password": "your_password", "grant_type": "password" }

2. Make API Calls

# Use Bearer token

GET

https://backend.cognitor.dev/auth/currentuser

Authorization: Bearer <token>

Base URL: https://backend.cognitor.dev

API Categories

Explore our comprehensive API organized by functionality

Authentication

3 endpoints

JWT-based authentication system with secure token management

Key Features:

Content Management

25 endpoints

Complete content lifecycle management with versioning and publishing

Key Features:

CRUD operationsContent typesPage builderPublishing workflow

Media & AI Generation

18 endpoints

AI-powered media generation and editing with FLUX and OpenAI

Key Features:

Image generationAI editingText-to-speechVideo generation

AI Services

12 endpoints

Advanced AI capabilities for content creation and optimization

Key Features:

Text generationSEO optimizationWebsite generationContent analysis

Search & Analytics

15 endpoints

Elasticsearch-powered search with real-time analytics

Key Features:

Full-text searchFaceted searchAnalyticsSuggestions

User Management

12 endpoints

Comprehensive user and site management with role-based permissions

Key Features:

User CRUDRole managementSite assignmentsPermissions

Billing & Transactions

8 endpoints

Credit system with transparent pricing and usage monitoring

Key Features:

Cost settingsCredit balanceUsage analyticsTransaction history

Public API

17 endpoints

Public endpoints for content delivery and website integration

Key Features:

Content deliveryPublic searchSite dataNo authentication

API Features

Built with modern standards and best practices

Security

• JWT Bearer authentication
• Role-based access control
• Rate limiting & monitoring
• Input validation & sanitization

Performance

• Redis caching layer
• Configurable timeouts
• Optimized database queries
• Async/await operations

Developer Experience

• Interactive Swagger UI
• Comprehensive error handling
• Detailed response schemas
• Code examples & SDKs

Documentation Resources

Everything you need to integrate with our API

Interactive API Docs

Swagger UI with live testing

OpenAPI Specification

Download the complete API spec

API Guide (ReDoc)

Alternative documentation view

Need help? Check out our comprehensive API documentation athttps://backend.cognitor.dev/docsfor interactive testing and detailed endpoint information.