API Documentation

Comprehensive REST API with 174 endpoints for content management, AI services, multi-tenant operations, subscription billing, and advanced analytics. Built with FastAPI, featuring automatic OpenAPI documentation, OAuth integration, and interactive testing.

174 Endpoints

OAuth & JWT

AI-Powered

Multi-Tenant

Stripe Billing

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 & Signup

11 endpoints

Complete authentication system with signup, OAuth, email verification and secure token management

Key Features:

Content Management

34 endpoints

Complete content lifecycle management with hierarchical pages, posts, elements and content types

Key Features:

Posts & PagesPage Hierarchy & NavigationContent ElementsContent TypesPublishing workflowForce deleteDependencies

Media & AI Generation

26 endpoints

AI-powered media generation and editing with FLUX, VEO3, OpenAI and comprehensive folder management

Key Features:

Image generationVideo generation (Kling/VEO3)AI editingText-to-speechMedia foldersAI metadata

User & Tenant Management

20 endpoints

Multi-tenant user and site management with role-based permissions and fraud detection

Key Features:

User CRUDTenant managementSite assignmentsRole permissionsUser-site associationsFraud detection

Billing & Payments

29 endpoints

Complete billing system with Stripe payments, subscriptions, credit packages and transparent pricing

Key Features:

Subscription managementCredit packagesStripe paymentsTransaction historyGlobal cost settingsTenant credits

Search & Analytics

18 endpoints

Elasticsearch-powered search with real-time analytics, site statistics and comprehensive monitoring

Key Features:

Full-text searchSearch analyticsSite statisticsPerformance metricsAdmin monitoringMonthly trends

SEO & Website Generation

3 endpoints

Advanced AI capabilities for content optimization and static website generation

Key Features:

SEO analysisText generationWebsite generationContent optimization

Public API

5 endpoints

Public endpoints for content delivery and website integration without authentication

Key Features:

Content elementsPublic pagesMedia deliveryNo authentication required

System Management

28 endpoints

System administration including prompts, cache management and comprehensive monitoring

Key Features:

Transfer promptsSystem promptsCache managementSecurity monitoringPerformance trackingRoot endpoint

API Features

Built with modern standards and best practices

Security

• JWT Bearer authentication
• OAuth integration (Google/GitHub)
• Role-based access control
• Fraud detection & monitoring
• Rate limiting & input validation

Performance

• Redis caching & analytics
• Real-time site statistics
• Configurable timeouts
• Optimized database queries
• Async/await operations

Developer Experience

• Interactive Swagger UI
• Comprehensive error handling
• Detailed response schemas
• Multi-tenant architecture
• Stripe integration ready

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.