API Documentation

Comprehensive REST API with 234 endpoints for agentic content operations, model services, multi-tenant governance, billing, and analytics. Built with FastAPI, featuring automatic OpenAPI documentation, OAuth integration, and interactive testing.

234 Endpoints

OAuth & JWT

Agent-Ready

Multi-Tenant

Stripe Billing

OpenAPI 3.1

Interactive API Docs (Swagger)Download OpenAPI Spec

Quick Start

Get started with the Cognitor Agent 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 & Access

26 endpoints

Authentication, service-account access, and prompt-control endpoints for secure agent operations

Key Features:

Content Operations

48 endpoints

Full content lifecycle across posts, pages, content types, elements, and translation workflows

Key Features:

Posts CRUDPages adminContent elementsContent typesSchema dependenciesTranslations

Media & Agent Generation

30 endpoints

Media management, folder orchestration, generation, editing, and website generation endpoints

Key Features:

Media CRUDMedia foldersImage/video generationAI editingTTSWebsite generation

User & Tenant Management

29 endpoints

Tenant-aware identity, site administration, and user-site assignment operations

Key Features:

Users CRUDSites CRUDTenant managementUser-site linksRole permissionsMulti-tenant administration

Billing & Economics

39 endpoints

Transactions, payments, subscriptions, and global cost settings for monetized agent operations

Key Features:

TransactionsCreditsStripe paymentsSubscriptionsGlobal cost settingsTenant credit controls

Search & Analytics

13 endpoints

Search indexing, query APIs, and site-level analytics endpoints

Key Features:

Public searchSearch suggestionsSearch statsAdmin reindexSite statisticsTrend endpoints

Operations & Security

18 endpoints

Platform monitoring, fraud controls, cache administration, and health endpoints

Key Features:

Admin monitoringFraud detectionCache controlsHealth checksThreat intelligenceSecurity dashboard

Public & Agent Runtime

31 endpoints

Public delivery endpoints plus agent runtime and operational root/contact surfaces

Key Features:

Public contentPublic mediaAgent APIsContact endpointRoot endpointUnauthenticated runtime

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.