BETA
This is a beta version of Cognitor for agentic teams. Features may be incomplete or subject to change.

API Documentation
BETA

Complete API reference for Cognitor agent workflows

Total Endpoints

234

Agent Operations

9

Public Access

31

Avg Timeout

45s

Authentication

Most endpoints require JWT authentication. Public endpoints are clearly marked for read-only agent access.

Token Type

JWT Bearer Token

Header Format

Authorization: Bearer <token>

Token Expiration

Configurable

User Roles

Admin
Editor
Author

Admin Fraud Detection
4 endpoints

Endpoints grouped under 'Admin Fraud Detection' from production OpenAPI.

GET
/admin/fraud/abuse-patterns

Get Abuse Patterns

Timeout: 20s
Auth Required
POST
/admin/fraud/block-tenant/{tenant_id}

Block Abusive Tenant

Timeout: 30s
Auth Required
GET
/admin/fraud/blocked-signups

Get Blocked Signups

Timeout: 20s
Auth Required
GET
/admin/fraud/suspicious-signups

Get Suspicious Signups

Timeout: 20s
Auth Required

Admin Content Types
1 endpoints

Endpoints grouped under 'Admin Content Types' from production OpenAPI.

POST
/admin/content-types/distribute

Distribute Content Type

Timeout: 30s
Auth Required

Admin Monitoring
7 endpoints

Endpoints grouped under 'Admin Monitoring' from production OpenAPI.

POST
/admin/monitoring/cache-cleanup

Trigger Cache Cleanup

Timeout: 30s
Auth Required
GET
/admin/monitoring/cache-statistics

Get Cache Stats

Timeout: 20s
Auth Required
GET
/admin/monitoring/performance-metrics

Get Performance Metrics

Timeout: 20s
Auth Required
GET
/admin/monitoring/rate-limit-stats

Get Rate Limit Statistics

Timeout: 20s
Auth Required
GET
/admin/monitoring/security-dashboard

Get Security Dashboard

Timeout: 20s
Auth Required
GET
/admin/monitoring/system-health

Get System Health

Timeout: 20s
Auth Required
GET
/admin/monitoring/threat-intelligence

Get Threat Intelligence

Timeout: 20s
Auth Required

Agents
17 endpoints

Endpoints grouped under 'Agents' from production OpenAPI.

GET
/api/agents

List Agents

Timeout: 20s
Auth Required
POST
/api/agents

Create Agent

Timeout: 30s
Auth Required
GET
/api/agents/

List Agents

Timeout: 20s
Auth Required
POST
/api/agents/

Create Agent

Timeout: 30s
Auth Required
GET
/api/agents/admin/all

Get All Agents With Tenants

Timeout: 20s
Auth Required
POST
/api/agents/knowledge-base/{doc_id}/compute-rag-index

Compute Rag Index

Timeout: 30s
Auth Required
GET
/api/agents/tenant/{tenant_id}/count

Get Tenant Agents Count

Timeout: 20s
Auth Required
DELETE
/api/agents/{agent_id}

Delete Agent

Timeout: 30s
Auth Required
GET
/api/agents/{agent_id}

Get Agent

Timeout: 20s
Auth Required
PATCH
/api/agents/{agent_id}

Update Agent

Timeout: 30s
Auth Required
POST
/api/agents/{agent_id}/avatar/{media_id}

Set Agent Avatar From Media

Timeout: 30s
Auth Required
GET
/api/agents/{agent_id}/knowledge-base

Get Agent Knowledge Base

Timeout: 20s
Auth Required
POST
/api/agents/{agent_id}/knowledge-base/from-post/{post_id}

Add Post To Knowledge Base

Timeout: 30s
Auth Required
DELETE
/api/agents/{agent_id}/knowledge-base/{doc_id}

Remove Knowledge Base Document

Timeout: 30s
Auth Required
GET
/api/agents/{agent_id}/tenants

Get Agent Tenants

Timeout: 20s
Auth Required
DELETE
/api/agents/{agent_id}/tenants/{tenant_id}

Remove Agent From Tenant

Timeout: 30s
Auth Required
POST
/api/agents/{agent_id}/tenants/{tenant_id}

Assign Agent To Tenant

Timeout: 30s
Auth Required

Authentication
13 endpoints

Endpoints grouped under 'Authentication' from production OpenAPI.

GET
/auth/currentuser

Get Current User Me

Timeout: 20s
Auth Required
POST
/auth/login
Public

Login

Timeout: 30s
Public Access
POST
/auth/logout

Logout

Timeout: 30s
Auth Required
POST
/auth/password-reset-confirm
Public

Confirm Password Reset

Timeout: 30s
Public Access
POST
/auth/password-reset-request
Public

Request Password Reset

Timeout: 30s
Public Access
POST
/auth/refresh-token

Refresh Token

Timeout: 30s
Auth Required
POST
/auth/signup/
Public

Signup

Timeout: 30s
Public Access
POST
/auth/signup/oauth/callback
Public

Oauth Callback

Timeout: 30s
Public Access
GET
/auth/signup/oauth/{provider}
Public

Initiate Oauth

Timeout: 20s
Public Access
POST
/auth/signup/resend-verification
Public

Resend Verification Email

Timeout: 30s
Public Access
POST
/auth/signup/verify-email
Public

Verify Email

Timeout: 30s
Public Access
POST
/auth/token
Public

Client Credentials Token

Timeout: 30s
Public Access
GET
/auth/token-info

Get Token Info

Timeout: 20s
Auth Required

Cache Management
3 endpoints

Endpoints grouped under 'Cache Management' from production OpenAPI.

DELETE
/admin/cache/all

Clear All Cache

Timeout: 30s
Auth Required
DELETE
/admin/cache/element/{element_id}/site/{site_id}

Clear Element Cache

Timeout: 30s
Auth Required
DELETE
/admin/cache/site/{site_id}

Clear Site Cache

Timeout: 30s
Auth Required

Contact
2 endpoints

Endpoints grouped under 'Contact' from production OpenAPI.

POST
/api/contact
Public

Submit Contact Form

Timeout: 30s
Public Access
GET
/api/contact/test-smtp

Test Smtp Configuration

Timeout: 20s
Auth Required

Content Elements Admin
6 endpoints

Endpoints grouped under 'Content Elements Admin' from production OpenAPI.

GET
/{site_identifier}/elements/

List Content Elements

Timeout: 20s
Auth Required
POST
/{site_identifier}/elements/

Create Content Element

Timeout: 30s
Auth Required
DELETE
/{site_identifier}/elements/{element_id}

Delete Content Element

Timeout: 30s
Auth Required
GET
/{site_identifier}/elements/{element_id}

Read Content Element

Timeout: 20s
Auth Required
PATCH
/{site_identifier}/elements/{element_id}

Update Content Element

Timeout: 30s
Auth Required
DELETE
/{site_identifier}/elements/{element_id}/force

Force Delete Content Element

Timeout: 30s
Auth Required

Content Types
8 endpoints

Endpoints grouped under 'Content Types' from production OpenAPI.

GET
/{site_identifier}/contenttypes/

List Content Types

Timeout: 20s
Auth Required
POST
/{site_identifier}/contenttypes/

Create Content Type

Timeout: 30s
Auth Required
POST
/{site_identifier}/contenttypes/validate

Validate Content Type Schema

Timeout: 30s
Auth Required
DELETE
/{site_identifier}/contenttypes/{type_id}

Delete Content Type

Timeout: 30s
Auth Required
GET
/{site_identifier}/contenttypes/{type_id}

Read Content Type

Timeout: 20s
Auth Required
PATCH
/{site_identifier}/contenttypes/{type_id}

Update Content Type

Timeout: 30s
Auth Required
POST
/{site_identifier}/contenttypes/{type_id}/copy

Copy Content Type

Timeout: 30s
Auth Required
GET
/{site_identifier}/contenttypes/{type_id}/dependencies

Get Content Type Dependencies

Timeout: 20s
Auth Required

General
5 endpoints

Endpoints grouped under 'General' from production OpenAPI.

GET
/
Public

Root

Timeout: 20s
Public Access
GET
/health
Public

Health Check

Timeout: 20s
Public Access
GET
/health/live
Public

Liveness Check

Timeout: 20s
Public Access
GET
/health/ready
Public

Readiness Check

Timeout: 20s
Public Access
GET
/health/redis
Public

Redis Health Check

Timeout: 20s
Public Access

Global Cost Settings
16 endpoints

Endpoints grouped under 'Global Cost Settings' from production OpenAPI.

GET
/admin/global-cost-settings/

List Global Cost Settings

Timeout: 20s
Auth Required
POST
/admin/global-cost-settings/

Create Global Cost Setting

Timeout: 30s
Auth Required
PUT
/admin/global-cost-settings/bulk

Bulk Update Global Cost Settings

Timeout: 30s
Auth Required
GET
/admin/global-cost-settings/credit-overview

Get Global Credit Overview

Timeout: 20s
Auth Required
GET
/admin/global-cost-settings/public

Get Public Global Cost Settings

Timeout: 20s
Auth Required
GET
/admin/global-cost-settings/readonly/current

Get Current Cost Settings Readonly

Timeout: 20s
Auth Required
GET
/admin/global-cost-settings/sites/{site_id}/credits

Get Site Credit Details

Timeout: 20s
Auth Required
GET
/admin/global-cost-settings/tenant-credits

Get All Tenant Credits

Timeout: 20s
Auth Required
POST
/admin/global-cost-settings/tenant-credits/allocate

Allocate Tenant Credits

Timeout: 30s
Auth Required
GET
/admin/global-cost-settings/tenant-credits/{tenant_id}

Get Tenant Credit Balance

Timeout: 20s
Auth Required
PATCH
/admin/global-cost-settings/tenant-credits/{tenant_id}/monthly-limit

Update Tenant Monthly Limit

Timeout: 30s
Auth Required
POST
/admin/global-cost-settings/user-credits/allocate

Allocate User Credits Directly

Timeout: 30s
Auth Required
GET
/admin/global-cost-settings/users/credits

Get All Users Credit Summary

Timeout: 20s
Auth Required
DELETE
/admin/global-cost-settings/{setting_id}

Delete Global Cost Setting

Timeout: 30s
Auth Required
GET
/admin/global-cost-settings/{setting_id}

Get Global Cost Setting

Timeout: 20s
Auth Required
PATCH
/admin/global-cost-settings/{setting_id}

Update Global Cost Setting

Timeout: 30s
Auth Required

Media
20 endpoints

Endpoints grouped under 'Media' from production OpenAPI.

GET
/{site_identifier}/media/

List Media Files

Timeout: 20s
Auth Required
POST
/{site_identifier}/media/

Upload File

Timeout: 60s
Auth Required
GET
/{site_identifier}/media/by-id/{media_id}

Get Media By Id

Timeout: 20s
Auth Required
GET
/{site_identifier}/media/count

Get Media Count

Timeout: 20s
Auth Required
POST
/{site_identifier}/media/generate

Generate Image

Timeout: 120s
Auth Required
POST
/{site_identifier}/media/generatevideo

Generate Video

Timeout: 300s
Auth Required
POST
/{site_identifier}/media/generatevideo-sora2

Generate Video Sora2

Timeout: 300s
Auth Required
POST
/{site_identifier}/media/generatevideo-veo3

Generate Video Veo3

Timeout: 300s
Auth Required
POST
/{site_identifier}/media/tts

Create Speech From Text

Timeout: 60s
Auth Required
POST
/{site_identifier}/media/webhook/fal
Public

Webhook Fal Result

Timeout: 60s
Public Access
DELETE
/{site_identifier}/media/{media_id}

Delete Media File

Timeout: 30s
Auth Required
GET
/{site_identifier}/media/{media_id}

Get Media Item

Timeout: 20s
Auth Required
PATCH
/{site_identifier}/media/{media_id}

Update Media Metadata

Timeout: 30s
Auth Required
POST
/{site_identifier}/media/{media_id}/edit-with-ai

Edit Image With Ai

Timeout: 120s
Auth Required
POST
/{site_identifier}/media/{media_id}/generate-metadata

Generate Media Metadata

Timeout: 120s
Auth Required
GET
/{site_identifier}/media/{media_id}/image-editor-access

Validate Image Editor Access

Timeout: 20s
Auth Required
GET
/{site_identifier}/media/{media_id}/image-versions

Get Image Versions

Timeout: 20s
Auth Required
POST
/{site_identifier}/media/{media_id}/move

Move Media File

Timeout: 60s
Auth Required
POST
/{site_identifier}/media/{media_id}/save-edited-image

Save Edited Image

Timeout: 60s
Auth Required
GET
/{site_identifier}/media/{media_id}/view
Public

View Media File

Timeout: 20s
Public Access

Media Folders
7 endpoints

Endpoints grouped under 'Media Folders' from production OpenAPI.

GET
/{site_identifier}/media/folders/

List Folders

Timeout: 20s
Auth Required
POST
/{site_identifier}/media/folders/

Create Folder

Timeout: 60s
Auth Required
GET
/{site_identifier}/media/folders/tree

Get Folder Tree

Timeout: 20s
Auth Required
DELETE
/{site_identifier}/media/folders/{folder_id}

Delete Folder

Timeout: 30s
Auth Required
GET
/{site_identifier}/media/folders/{folder_id}

Get Folder

Timeout: 20s
Auth Required
PATCH
/{site_identifier}/media/folders/{folder_id}

Update Folder

Timeout: 30s
Auth Required
POST
/{site_identifier}/media/folders/{folder_id}/move

Move Folder

Timeout: 60s
Auth Required

Pages Admin
13 endpoints

Endpoints grouped under 'Pages Admin' from production OpenAPI.

GET
/{site_identifier}/pages/

List Pages

Timeout: 20s
Auth Required
POST
/{site_identifier}/pages/

Create Page

Timeout: 30s
Auth Required
POST
/{site_identifier}/pages/batch-move

Batch Move Pages

Timeout: 30s
Auth Required
POST
/{site_identifier}/pages/reorder

Reorder Pages

Timeout: 30s
Auth Required
GET
/{site_identifier}/pages/tree

Get Page Tree

Timeout: 20s
Auth Required
DELETE
/{site_identifier}/pages/{page_id}

Delete Page

Timeout: 30s
Auth Required
GET
/{site_identifier}/pages/{page_id}

Read Page

Timeout: 20s
Auth Required
PATCH
/{site_identifier}/pages/{page_id}

Update Page

Timeout: 30s
Auth Required
POST
/{site_identifier}/pages/{page_id}/elements

Add Element To Page

Timeout: 30s
Auth Required
POST
/{site_identifier}/pages/{page_id}/elements/batch-update

Batch Update Page Elements

Timeout: 30s
Auth Required
DELETE
/{site_identifier}/pages/{page_id}/elements/{element_id}

Remove Element From Page

Timeout: 30s
Auth Required
PATCH
/{site_identifier}/pages/{page_id}/elements/{element_id}

Update Page Element

Timeout: 30s
Auth Required
PUT
/{site_identifier}/pages/{page_id}/move

Move Page

Timeout: 30s
Auth Required

Payments
4 endpoints

Endpoints grouped under 'Payments' from production OpenAPI.

POST
/{site_identifier}/payments/create-checkout-session

Create Stripe Checkout Session

Timeout: 30s
Auth Required
GET
/{site_identifier}/payments/credit-packages

Get Credit Packages

Timeout: 20s
Auth Required
GET
/{site_identifier}/payments/transactions

Get Payment Transactions

Timeout: 20s
Auth Required
GET
/{site_identifier}/payments/transactions/{transaction_id}

Get Payment Transaction

Timeout: 20s
Auth Required

Payments Webhooks
1 endpoints

Endpoints grouped under 'Payments Webhooks' from production OpenAPI.

POST
/payments/webhook
Public

Stripe Webhook Handler

Timeout: 30s
Public Access

Posts
9 endpoints

Endpoints grouped under 'Posts' from production OpenAPI.

GET
/{site_identifier}/posts/

Get Posts

Timeout: 20s
Auth Required
POST
/{site_identifier}/posts/

Create Post

Timeout: 30s
Auth Required
POST
/{site_identifier}/posts/from-pdf

Create Post From Pdf

Timeout: 30s
Auth Required
POST
/{site_identifier}/posts/from-url

Create Post From Url

Timeout: 30s
Auth Required
DELETE
/{site_identifier}/posts/{post_id}

Delete Post

Timeout: 30s
Auth Required
GET
/{site_identifier}/posts/{post_id}

Get Post

Timeout: 20s
Auth Required
PATCH
/{site_identifier}/posts/{post_id}

Update Post

Timeout: 30s
Auth Required
POST
/{site_identifier}/posts/{post_id}/recrawl

Recrawl Post

Timeout: 30s
Auth Required
POST
/{site_identifier}/posts/{post_id}/transform

Transform Post

Timeout: 30s
Auth Required

Public Content
10 endpoints

Endpoints grouped under 'Public Content' from production OpenAPI.

GET
/public/{site_identifier}/content-types
Public

List Public Content Types

Timeout: 20s
Public Access
GET
/public/{site_identifier}/elements
Public

List Public Content Elements

Timeout: 20s
Public Access
GET
/public/{site_identifier}/elements/{element_id}
Public

Read Public Content Element

Timeout: 20s
Public Access
GET
/public/{site_identifier}/elements/{element_id}/references
Public

Get Content Element References

Timeout: 20s
Public Access
GET
/public/{site_identifier}/locales
Public

Get Site Locales

Timeout: 20s
Public Access
GET
/public/{site_identifier}/media/{media_id}
Public

Get Public Media Metadata

Timeout: 20s
Public Access
GET
/public/{site_identifier}/media/{media_id}/view
Public

View Public Media

Timeout: 20s
Public Access
GET
/public/{site_identifier}/navigation
Public

Get Public Navigation

Timeout: 20s
Public Access
GET
/public/{site_identifier}/pages
Public

List Public Pages

Timeout: 20s
Public Access
GET
/public/{site_identifier}/pages/{page_id}
Public

Read Public Page

Timeout: 20s
Public Access

Search
7 endpoints

Endpoints grouped under 'Search' from production OpenAPI.

GET
/search/admin/health

Elasticsearch Health

Timeout: 20s
Auth Required
DELETE
/search/admin/sites/{site_identifier}/index

Delete Site Index

Timeout: 30s
Auth Required
POST
/search/admin/sites/{site_identifier}/reindex

Reindex Site Content

Timeout: 300s
Auth Required
GET
/search/sites/{site_identifier}
Public

Search Site Content

Timeout: 20s
Public Access
GET
/search/sites/{site_identifier}/analytics

Get Search Analytics

Timeout: 20s
Auth Required
GET
/search/sites/{site_identifier}/stats

Get Search Stats

Timeout: 20s
Auth Required
GET
/search/sites/{site_identifier}/suggest
Public

Get Search Suggestions

Timeout: 20s
Public Access

Seo
2 endpoints

Endpoints grouped under 'Seo' from production OpenAPI.

POST
/{site_identifier}/seo/analyze

Analyze Content For Seo

Timeout: 30s
Auth Required
POST
/{site_identifier}/seo/generatetext

Generate Text

Timeout: 120s
Auth Required

Service Accounts
5 endpoints

Endpoints grouped under 'Service Accounts' from production OpenAPI.

GET
/api/service-accounts/

List Service Accounts

Timeout: 20s
Auth Required
POST
/api/service-accounts/

Create Service Account

Timeout: 30s
Auth Required
DELETE
/api/service-accounts/{service_account_id}

Delete Service Account

Timeout: 30s
Auth Required
GET
/api/service-accounts/{service_account_id}

Get Service Account

Timeout: 20s
Auth Required
PATCH
/api/service-accounts/{service_account_id}

Update Service Account

Timeout: 30s
Auth Required

Site Statistics
6 endpoints

Endpoints grouped under 'Site Statistics' from production OpenAPI.

GET
/{site_identifier}/site-statistics/diagnostic

Get Diagnostic Info

Timeout: 20s
Auth Required
GET
/{site_identifier}/site-statistics/endpoints

Get Endpoint Metrics

Timeout: 20s
Auth Required
GET
/{site_identifier}/site-statistics/health
Public

Get Statistics Health

Timeout: 20s
Public Access
GET
/{site_identifier}/site-statistics/monthly

Get Monthly Statistics

Timeout: 20s
Auth Required
GET
/{site_identifier}/site-statistics/overview

Get Site Statistics Overview

Timeout: 20s
Auth Required
GET
/{site_identifier}/site-statistics/sites

Get Site Breakdown

Timeout: 20s
Auth Required

Sites
6 endpoints

Endpoints grouped under 'Sites' from production OpenAPI.

GET
/sites/

Get Sites

Timeout: 20s
Auth Required
POST
/sites/

Create Site

Timeout: 30s
Auth Required
GET
/sites/by-tenant/{tenant_id}

Get Sites By Tenant

Timeout: 20s
Auth Required
DELETE
/sites/{site_identifier}

Delete Site

Timeout: 30s
Auth Required
GET
/sites/{site_identifier}

Get Site

Timeout: 20s
Auth Required
PATCH
/sites/{site_identifier}

Update Site

Timeout: 30s
Auth Required

Subscription
7 endpoints

Endpoints grouped under 'Subscription' from production OpenAPI.

POST
/subscription/allocate-monthly-credits

Allocate Monthly Credits Manually

Timeout: 30s
Auth Required
POST
/subscription/cancel

Cancel Subscription Endpoint

Timeout: 30s
Auth Required
GET
/subscription/current

Get Subscription Status

Timeout: 20s
Auth Required
POST
/subscription/portal

Create Billing Portal Session

Timeout: 30s
Auth Required
GET
/subscription/storage

Get Storage Stats

Timeout: 20s
Auth Required
POST
/subscription/upgrade

Upgrade Subscription

Timeout: 30s
Auth Required
GET
/subscription/verify-upgrade

Verify Subscription Upgrade

Timeout: 20s
Auth Required

System Prompts
4 endpoints

Endpoints grouped under 'System Prompts' from production OpenAPI.

GET
/system-prompts/

Get All System Prompts

Timeout: 20s
Auth Required
DELETE
/system-prompts/{prompt_type}

Delete System Prompt

Timeout: 30s
Auth Required
GET
/system-prompts/{prompt_type}

Get System Prompt

Timeout: 20s
Auth Required
POST
/system-prompts/{prompt_type}

Create Or Update System Prompt

Timeout: 30s
Auth Required

Tenant Management
12 endpoints

Endpoints grouped under 'Tenant Management' from production OpenAPI.

GET
/admin/tenants/

List Tenants

Timeout: 20s
Auth Required
POST
/admin/tenants/

Create Tenant

Timeout: 30s
Auth Required
GET
/admin/tenants/current/info

Get Current User Tenant Context

Timeout: 20s
Auth Required
DELETE
/admin/tenants/{tenant_id}

Delete Tenant

Timeout: 30s
Auth Required
GET
/admin/tenants/{tenant_id}

Get Tenant

Timeout: 20s
Auth Required
PATCH
/admin/tenants/{tenant_id}

Update Tenant

Timeout: 30s
Auth Required
GET
/admin/tenants/{tenant_id}/available-users

List Available Users For Tenant

Timeout: 20s
Auth Required
POST
/admin/tenants/{tenant_id}/clone

Clone Tenant

Timeout: 30s
Auth Required
GET
/admin/tenants/{tenant_id}/users

List Tenant Users

Timeout: 20s
Auth Required
DELETE
/admin/tenants/{tenant_id}/users/{user_id}

Remove User From Tenant

Timeout: 30s
Auth Required
PATCH
/admin/tenants/{tenant_id}/users/{user_id}

Update User Role In Tenant

Timeout: 30s
Auth Required
POST
/admin/tenants/{tenant_id}/users/{user_id}

Assign User To Tenant

Timeout: 30s
Auth Required

Transactions
11 endpoints

Endpoints grouped under 'Transactions' from production OpenAPI.

GET
/{site_identifier}/transactions/

List Transactions

Timeout: 20s
Auth Required
GET
/{site_identifier}/transactions/cost-settings

Get Cost Settings

Timeout: 20s
Auth Required
PUT
/{site_identifier}/transactions/cost-settings

Update Cost Settings

Timeout: 30s
Auth Required
POST
/{site_identifier}/transactions/credits/add

Add Credits

Timeout: 30s
Auth Required
POST
/{site_identifier}/transactions/credits/allocate-from-tenant

Allocate User Credits From Tenant

Timeout: 30s
Auth Required
GET
/{site_identifier}/transactions/credits/balance

Get Credit Balance

Timeout: 20s
Auth Required
GET
/{site_identifier}/transactions/credits/balance-with-tenant

Get Credit Balance With Tenant Info

Timeout: 20s
Auth Required
POST
/{site_identifier}/transactions/credits/check

Check Credits

Timeout: 30s
Auth Required
GET
/{site_identifier}/transactions/credits/site-users

Get Site User Credits

Timeout: 20s
Auth Required
GET
/{site_identifier}/transactions/monthly-usage

Get Monthly Usage

Timeout: 20s
Auth Required
GET
/{site_identifier}/transactions/stats

Get Transaction Stats

Timeout: 20s
Auth Required

Transferprompts
4 endpoints

Endpoints grouped under 'Transferprompts' from production OpenAPI.

GET
/transferprompts/

List Transfer Prompts

Timeout: 20s
Auth Required
POST
/transferprompts/

Create Transfer Prompt

Timeout: 30s
Auth Required
DELETE
/transferprompts/{prompt_id}

Delete Transfer Prompt

Timeout: 30s
Auth Required
PATCH
/transferprompts/{prompt_id}

Update Transfer Prompt

Timeout: 30s
Auth Required

Translations
12 endpoints

Endpoints grouped under 'Translations' from production OpenAPI.

GET
/{site_identifier}/translations/elements/{element_id}

Get all translations of a content element

Timeout: 20s
Auth Required
POST
/{site_identifier}/translations/elements/{element_id}/sync-translations

Sync all translations with the master element

Timeout: 30s
Auth Required
POST
/{site_identifier}/translations/elements/{element_id}/translate

Translate a content element to another language

Timeout: 30s
Auth Required
GET
/{site_identifier}/translations/media/{media_id}

Get all translations of a media item

Timeout: 20s
Auth Required
POST
/{site_identifier}/translations/media/{media_id}/sync-translations

Sync all translations with the master media

Timeout: 60s
Auth Required
POST
/{site_identifier}/translations/media/{media_id}/translate

Translate a media item to another language

Timeout: 60s
Auth Required
GET
/{site_identifier}/translations/pages/{page_id}

Get all translations of a page

Timeout: 20s
Auth Required
POST
/{site_identifier}/translations/pages/{page_id}/sync-translations

Sync all translations with the master page

Timeout: 30s
Auth Required
POST
/{site_identifier}/translations/pages/{page_id}/translate

Translate a page to another language

Timeout: 30s
Auth Required
GET
/{site_identifier}/translations/posts/{post_id}

Get all translations of a post

Timeout: 20s
Auth Required
POST
/{site_identifier}/translations/posts/{post_id}/sync-translations

Sync all translations with the master post

Timeout: 30s
Auth Required
POST
/{site_identifier}/translations/posts/{post_id}/translate

Translate a post to another language

Timeout: 30s
Auth Required

User Site Associations
5 endpoints

Endpoints grouped under 'User Site Associations' from production OpenAPI.

GET
/sites/{site_identifier}/available-users

List users available for assignment to a specific site

Timeout: 20s
Auth Required
GET
/sites/{site_identifier}/users

List users with access to a site

Timeout: 20s
Auth Required
DELETE
/sites/{site_identifier}/users/{user_id}

Remove a user from a site

Timeout: 30s
Auth Required
POST
/sites/{site_identifier}/users/{user_id}

Assign a user to a site

Timeout: 30s
Auth Required
GET
/users/{user_id}/sites

List sites a user is assigned to

Timeout: 20s
Auth Required

Users
6 endpoints

Endpoints grouped under 'Users' from production OpenAPI.

GET
/users/

Get Users

Timeout: 20s
Auth Required
POST
/users/

Create User

Timeout: 30s
Auth Required
DELETE
/users/{user_id}

Delete User

Timeout: 30s
Auth Required
GET
/users/{user_id}

Get User

Timeout: 20s
Auth Required
PATCH
/users/{user_id}

Update User

Timeout: 30s
Auth Required
PATCH
/users/{user_id}/global-admin

Update Global Admin Status

Timeout: 30s
Auth Required

Website Generation
1 endpoints

Endpoints grouped under 'Website Generation' from production OpenAPI.

POST
/{site_identifier}/generate-website/

Generate Website

Timeout: 120s
Auth Required

Quick Start

Get started with the Cognitor Agent API in minutes

1. Authentication

curl -X POST "https://backend.cognitor.dev/auth/login" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "username=your@email.com&password=your_password&grant_type=password"

2. Make API Calls

curl -X GET "https://backend.cognitor.dev/sites/" \ -H "Authorization: Bearer YOUR_JWT_TOKEN"