# Lilith API Documentation

This documentation is automatically generated from the OpenAPI specifications.

## Overview

## Welcome to the Lilith API Documentation

The Lilith AI Wisdom Platform API provides comprehensive access to AI-powered
wisdom content through chat interactions, lectures, meditations, and voice
experiences. Our platform delivers personalized spiritual and philosophical
guidance through multiple interaction modes.

## Key Features

- **Intelligent Chat**: Engage with AI personas trained in various wisdom
  traditions
- **Lecture Generation**: Generate comprehensive lectures with citations and
  audio
- **Text-to-Speech**: High-quality voice synthesis with multiple voice options
- **Content Ingestion**: Submit and process wisdom content from various sources
- **Real-time Streaming**: WebSocket and SSE support for live interactions
- **Audio Processing**: Advanced audio streaming and synthesis capabilities

## Getting Started

1. **Authentication**: Obtain API keys from your developer dashboard
2. **Choose Integration**: Select from REST API, WebSocket, or our SDKs
3. **Explore**: Try our interactive examples and code samples
4. **Build**: Integrate wisdom features into your application

For detailed setup instructions, see our
[Getting Started Guide](../user-guides/guides/getting-started.md).

## Services

- **Health**: Health check and system status endpoints
- **Chat**: Intelligent chat interactions with AI personas trained in various
  wisdom traditions. Supports both text and voice inputs with streaming
  responses via SSE or WebSocket.

- **Lectures**: Generate comprehensive lectures with citations and audio
  synthesis. Perfect for educational content creation with customizable duration
  and depth.

- **TTS**: High-quality text-to-speech synthesis with multiple voice options and
  SSML support. Supports both streaming and batch audio generation.

- **Audio**: Audio processing and streaming capabilities
- **Media**: Media metadata, packaging, and signed URLs
- **Ingestion**: Submit and process wisdom content from various sources
  including books, articles, podcasts, and other educational materials for
  inclusion in the knowledge base.

- **Notifications**: Push notifications and email delivery system
- **Users**: User management and profile endpoints
- **Content**: Content catalog, courses, and versioning
- **auth**: Auth service endpoints
- **bff**: Bff service endpoints
- **conversation**: Conversation service endpoints
- **content**: Content service endpoints
- **media**: Media service endpoints
- **notification**: Notification service endpoints
- **moderation**: Moderation service endpoints
- **ai**: Ai service endpoints
- **rag**: Rag service endpoints
- **observability**: Observability service endpoints

## Endpoints

### GET /v1/health

Service health check endpoint

**Tags**: rag

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/auth/login

User authentication endpoint

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### GET /v1/users/profile

Retrieve the authenticated user's profile information

**Tags**: Users

**Responses**:

- 200: User profile retrieved successfully
- 401: undefined

### POST /v1/chat

POST operation for /v1/chat

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/content

Content CRUD operations

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/content

Get all content with filtering and pagination

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/media/{media_id}

Retrieve metadata and signed URLs for media content

**Tags**: Media

**Responses**:

- 200: Media metadata retrieved

### GET /v1/audio/stream/{stream_id}

Stream audio content with HLS or direct streaming

**Tags**: Audio

**Responses**:

- 200: Audio stream

### POST /v1/lectures

POST operation for /v1/lectures

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tts/synthesize

Synthesize speech from text

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/notifications

Send push notifications to user devices

**Tags**: Notifications

**Responses**:

- 200: Notification sent successfully

### POST /v1/ingest

Proxy content ingestion requests to the configured Lilith content service.

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/notifications/test

Test notification (for admin/testing)

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /health

Health check endpoint for infrastructure monitoring

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /metrics

Remove from active requests

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/auth/register

User registration and authentication

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### POST /v1/auth/refresh

Token refresh endpoint

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### POST /v1/auth/logout

User logout endpoint

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### GET /v1/users/:id/profile

User profile management

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/users/:id/profile

Default for tests

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/consent

Consent management

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/consent-history

Send response with 200 status as expected by tests

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/auth/magic-link

Request a passwordless magic link for email-based authentication.

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### POST /v1/auth/webauthn/registration/begin

WebAuthn Registration endpoints

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### POST /v1/auth/webauthn/registration/finish

POST operation for /v1/auth/webauthn/registration/finish

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### POST /v1/auth/webauthn/authentication/begin

WebAuthn Authentication endpoints

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### POST /v1/auth/webauthn/authentication/finish

POST operation for /v1/auth/webauthn/authentication/finish

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### GET /v1/users/:id/webauthn/credentials

WebAuthn credential management

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### DELETE /v1/users/:id/webauthn/credentials/:credentialId

Delete user data

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/data-export

Data Export (DSAR - Data Subject Access Request)

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/data-export-history

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/data-deletion

Data Deletion (Right to be forgotten)

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/data-deletion-history

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/data-deletion/:deletionId/cancel

Create or manage user data

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/data-deletion/:deletionId/execute

Create or manage user data

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/data-map

Data Mapping

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/privacy/compliance-status

Compliance Status Endpoints

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/privacy/retention-policies

GET operation for /v1/privacy/retention-policies

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/privacy/policies

Privacy Policy Management

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/privacy/policies/:policyId/versions/:version/publish

POST operation for /v1/privacy/policies/:policyId/versions/:version/publish

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/privacy/policies/:policyId/current

GET operation for /v1/privacy/policies/:policyId/current

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/privacy/policies/:policyId/versions

GET operation for /v1/privacy/policies/:policyId/versions

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/privacy/policies/:policyId/versions/:version

GET operation for /v1/privacy/policies/:policyId/versions/:version

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/privacy/consent-texts

Consent Text Management

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/privacy/consent-texts/:consentType/versions/:version/publish

POST operation for
/v1/privacy/consent-texts/:consentType/versions/:version/publish

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/privacy/consent-texts/current

GET operation for /v1/privacy/consent-texts/current

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/privacy/consent-texts/:consentType/versions/:version

GET operation for /v1/privacy/consent-texts/:consentType/versions/:version

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/consent-enhanced

Enhanced Consent Management

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/consent-history-enhanced

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/consent-status

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/consent-compliance-check

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/privacy/consent-bundle

Integration Endpoints

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/privacy/validate-consent-submission

POST operation for /v1/privacy/validate-consent-submission

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/auth/.well-known/openid-configuration

OIDC discovery endpoint

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 401: Unauthorized
- 500: Internal Server Error

### POST /v1/users/:id/personalization/vectors

Personalization Vector endpoints

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/personalization/vectors

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/personalization/vectors/:vectorId

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/users/:id/personalization/vectors/:vectorId

Update user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### DELETE /v1/users/:id/personalization/vectors/:vectorId

Delete user data

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/personalization/privacy-budget

Privacy Budget endpoints

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/personalization/privacy-budget/consume

Create or manage user data

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:id/personalization/privacy-budget/reset

Create or manage user data

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/personalization/privacy-budget/analytics

Retrieve user information

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/personalization/privacy-levels

Privacy levels endpoint

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/personalization/cleanup/expired

Data cleanup and retention endpoints

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/personalization/retention-policies

Limit log size

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/users/:id/personalization/cleanup

Create or manage user data

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:id/personalization/audit-logs

Audit logs endpoint

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/tokens/add

Add Web3 token to user profile after successful payment

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 500: Internal Server Error

### GET /v1/users/:walletAddress/tokens

Get user's Web3 tokens

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/users/:walletAddress/tokens/:tokenId

Update token status (e.g., deactivate)

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:walletAddress/tokens/stats

Get user token statistics

**Tags**: auth

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/personas

Personas endpoint - serves the 3 core personas with configuration

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/personas/:personaId

Get specific persona by ID

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/chat/comparative

Comparative chat endpoint - queries multiple personas and optionally synthesizes
responses

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/chat/comparative/:comparativeId

Get comparative response by ID

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/users/:userId/language-preferences

User language preferences management

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:userId/language-preferences

Retrieve user information

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/detect-language

Language detection test endpoint

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/config/tracing

=== Tracing Configuration and Testing Endpoints ===

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tracing/test

POST operation for /v1/tracing/test

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/circuit-breaker/status

=== Circuit Breaker Endpoints ===

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/circuit-breaker/status/:serviceName

GET operation for /v1/circuit-breaker/status/:serviceName

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/circuit-breaker/config

POST operation for /v1/circuit-breaker/config

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/circuit-breaker/test-failure

POST operation for /v1/circuit-breaker/test-failure

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tts:synthesize

POST operation for /v1/tts:synthesize

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/dashboard

Combined/aggregated endpoints for client optimization

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/conversation-context/:conversationId

GET operation for /v1/conversation-context/:conversationId

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/user-session

GET operation for /v1/user-session

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/bulk-operations

POST operation for /v1/bulk-operations

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/errors/schema

Error normalization endpoints

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/errors/normalize

POST operation for /v1/errors/normalize

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/errors/test/:errorType

GET operation for /v1/errors/test/:errorType

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/experiments

Experiment and version management endpoints

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/experiments/:experimentId/assign

POST operation for /v1/experiments/:experimentId/assign

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/models/versions

GET operation for /v1/models/versions

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/models/negotiate

POST operation for /v1/models/negotiate

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/users/:userId/memory

User Memory Overview - Aggregates memory from Auth and AI services

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:userId/memory/controls

Memory Control Panel - User-friendly memory management

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/chat/personalized

Personalized Chat with Memory Integration

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator

Curator workbench endpoints

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator/import

GET operation for /curator/import

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator/licenses

GET operation for /curator/licenses

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator/tags

GET operation for /curator/tags

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator/diff

GET operation for /curator/diff

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator/workflow

GET operation for /curator/workflow

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator/analytics

GET operation for /curator/analytics

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /curator/quality

GET operation for /curator/quality

**Tags**: bff

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/test/reset

Test utility endpoint - only for test environments

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/ws/chat

GET operation for /v1/ws/chat

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/conversations/threads

{ input: { text }, persona, stream } and ensures tracing headers on response.

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/ws/status

WebSocket status endpoint

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/threads

Thread management endpoints

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/threads

Also create in legacy conversations map for backward compatibility

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/threads/:threadId

GET operation for /v1/threads/:threadId

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### PATCH /v1/threads/:threadId

PATCH operation for /v1/threads/:threadId

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### DELETE /v1/threads/:threadId

DELETE operation for /v1/threads/:threadId

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/threads/:threadId/messages

Message management endpoints

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/threads/:threadId/messages

POST operation for /v1/threads/:threadId/messages

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/threads/:threadId/messages/:messageId

GET operation for /v1/threads/:threadId/messages/:messageId

**Tags**: conversation

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id

GET operation for /v1/content/:id

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/content/:id

PUT operation for /v1/content/:id

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### DELETE /v1/content/:id

Delete content (soft delete)

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/versions

GET operation for /v1/content/:id/versions

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/:id/transition

Content workflow transitions

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/:id/locales

Locale variants

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/auto-switch

Smart content retrieval with auto-switching

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/content/auto-switch/batch

Batch auto-switching for multiple content items

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/content/:id/languages

Language availability check endpoint

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/recommendations

Content recommendation based on language preferences

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/courses/:courseId

Get course by ID with optional JSON-LD

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/courses/:courseId

Update course

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/courses

Get all courses with optional JSON-LD

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/courses

POST operation for /v1/courses

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/courses/:courseId/progress/:userId

Course progress tracking

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/courses/:courseId/progress/:userId

PUT operation for /v1/courses/:courseId/progress/:userId

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/schedules

Scheduling

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/courses/sitemap/jsonld

JSON-LD sitemap endpoint for all courses

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/schedules/:id/today

GET operation for /v1/schedules/:id/today

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/playlists

Playlists

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/content/:id/export/srt

Export functionality

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/export/vtt

GET operation for /v1/content/:id/export/vtt

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/:id/landing-page

Landing page generation

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/facets

GET operation for /v1/content/facets

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/content/:id/translations/compare

Translation comparison endpoints

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/translations/diff

GET operation for /v1/content/:id/translations/diff

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/translations/quality

GET operation for /v1/content/:id/translations/quality

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/translations

GET operation for /v1/content/:id/translations

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/search

Enhanced search with translation parameters

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/content/translations/stats

Translation coverage statistics

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/content/:id/cultural-context

Create cultural context for wisdom content localization

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/:id/cultural-adaptations

Apply cultural adaptations to translated content

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/:id/cultural-review

Submit content for cultural advisory review

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/cultural-review/:reviewId/complete

Complete cultural advisory review (for cultural advisors)

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/cultural-context/:contextId

Get cultural context information

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/localization-recommendations

Get wisdom content localization recommendations

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/:id/cultural-status

Get cultural adaptation status for content

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/curricula

Create structured curriculum

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/curricula/:curriculumId

Get curriculum with adaptive recommendations

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/learning-paths

Learning path management

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/competencies

Competency tracking

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/scholar-notes

Scholar Notes functionality

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/scholar-notes/:userId

GET operation for /v1/scholar-notes/:userId

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/reflections/daily

Daily Reflections functionality

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/reflections/daily/:userId

GET operation for /v1/reflections/daily/:userId

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/analytics/learning/:userId

Learning analytics endpoint

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/content/:id/verify-access

Verify user access to specific content via Web3 tokens

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/my-access

Get user's accessible content based on their Web3 tokens

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/content/batch-verify-access

Batch verify access to multiple content items

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/content/:id/access-requirements

Get content access requirements for premium content

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/content/access-stats

Get content access statistics for admin/analytics

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/content/access/update

Update user content access after payment settlement

**Tags**: content

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/media

Media asset management

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/media/:id

GET operation for /v1/media/:id

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### DELETE /v1/media/:id

DELETE operation for /v1/media/:id

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/signed-url

Signed URL generation

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/verify

Media integrity verification

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/package

HLS packaging

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/waveform

Waveform generation

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/process

Audio processing

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/media/:id/processing-status

Update media status

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/normalize

Audio normalization

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/silence-detection

Silence detection

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/media/:id/quality-analysis

Quality analysis

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/media/:id/storage-info

Storage management

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/storage-transition

$0.023/GB/month

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/media/:id/retention

Retention management

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/media/:id/cdn-info

CDN management

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/:id/cdn-purge

POST operation for /v1/media/:id/cdn-purge

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/media/:id/replication-status

Replication status

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/transcripts

Transcript management

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/transcripts/:id/export/srt

GET operation for /v1/transcripts/:id/export/srt

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/transcripts/:id/export/vtt

GET operation for /v1/transcripts/:id/export/vtt

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/transcripts/:id/search

GET operation for /v1/transcripts/:id/search

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/backup-policies

Backup management

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/media/upload-direct

Direct S3 operations

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/media/:id/confirm-upload

POST operation for /v1/media/:id/confirm-upload

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/media/bulk-delete

Bulk operations

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/media/storage-stats

GET operation for /v1/media/storage-stats

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/media/bucket-info

S3 bucket operations

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/tts/voices

Get available TTS voices

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/tts/jobs/:jobId

Get TTS job status

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/tts/batch

Batch TTS synthesis

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tts/validate-ssml

SSML (Speech Synthesis Markup Language) validation

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tts/voices/clone

Voice cloning (enterprise feature)

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tts/effects

Audio effects processing

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/tts/stats

Get TTS usage statistics

**Tags**: media

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/notification-templates

Template management

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/users/:userId/subscriptions

Subscription management

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:userId/subscriptions

Retrieve user information

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### PUT /v1/users/:userId/quiet-hours

Quiet hours configuration

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/notifications/send

Send notification

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/notifications/send-batch

Batch notifications

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/users/:userId/digest-preferences

Digest management

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:userId/notification-history

Notification history and analytics

**Tags**: notification

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/moderate

Analyze content for moderation

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/moderate/batch

Batch moderation

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### PUT /v1/filters/:category

Configure content filters

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/filters

Get filter configuration

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/patterns/blocked

Add blocked pattern

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/users/:userId/history

Get user moderation history

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/users/:userId/reputation

Check user reputation

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 403: Forbidden
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/appeals

Appeal moderation decision

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/moderate/stream

Real-time content streaming moderation

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/stats

Get moderation statistics

**Tags**: moderation

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/ai/complete

Main AI completion endpoint

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/ai/providers

Provider management

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/ai/providers

GET operation for /v1/ai/providers

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/ai/personas/:personaKey/prompts

System prompt management

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/ai/personas/:personaKey/prompts

GET operation for /v1/ai/personas/:personaKey/prompts

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/ai/usage/:userId

Usage tracking and limits

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/ai/templates

Lecture and meditation template endpoints

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/ai/templates

GET operation for /v1/ai/templates

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/ai/templates/:templateId

GET operation for /v1/ai/templates/:templateId

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/ai/templates/:templateId/generate

POST operation for /v1/ai/templates/:templateId/generate

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/ai/content/:contentId

GET operation for /v1/ai/content/:contentId

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/ai/assessments/checklist

Self-assessment endpoints

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/ai/assessments/rating

30s per item

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/ai/providers/:providerId/health

Provider health and routing

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/agents

Agent Registration and Management

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/agents

GET operation for /v1/agents

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/agents/:agentId

GET operation for /v1/agents/:agentId

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/agents/sessions

Multi-Agent Coordination Sessions

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/agents/sessions/:sessionId

GET operation for /v1/agents/sessions/:sessionId

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/agents/memory/:userId

Agent Memory Management

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### POST /v1/agents/memory/:userId/store

POST operation for /v1/agents/memory/:userId/store

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### DELETE /v1/agents/memory/:userId/reset

DELETE operation for /v1/agents/memory/:userId/reset

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/agents/protocols

Protocol Execution Status

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/golden-sets

Golden Sets Management endpoints

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/golden-sets

GET operation for /v1/evaluations/golden-sets

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/traditions

GET operation for /v1/evaluations/traditions

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/evaluate

Evaluation Engine endpoints

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/evaluate-batch

Store result

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/schedules

Evaluation Scheduling endpoints

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/runs/execute

POST operation for /v1/evaluations/runs/execute

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/runs/:runId/results

Short delay for testing

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/evaluations/trends

Evaluation Analytics endpoints

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/dashboard

GET operation for /v1/evaluations/dashboard

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/export

POST operation for /v1/evaluations/export

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/export

Export evaluation data

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/insights

30 seconds

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/alerts

Alert configuration endpoints

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/nightly/config

Configure nightly evaluation schedules

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/datasets

Manage evaluation datasets

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/nightly/schedules

List evaluation schedules

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/nightly/run

Run nightly evaluation

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/nightly/status/:executionId

Check evaluation status

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/evaluations/nightly/reports/latest

Get latest evaluation report

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/nightly/violations

Handle threshold violations

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/factuality/run

Run factuality evaluation

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/factuality/trends

Get factuality trends

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/factuality/analysis

Factuality error analysis

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/sensitivity/run

Run sensitivity evaluation

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/sensitivity/harm-detection

Harm detection analysis

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/sensitivity/bias-analysis

Bias analysis across demographics

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/style/run

Run style evaluation

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/style/comparison

Style comparison across traditions

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/style/evolution

Style evolution tracking

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/monitoring/dashboard

Quality monitoring dashboard

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/thresholds/config

Configure thresholds

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/evaluations/regression/run

Regression testing

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/regression/results/latest

Regression test results

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/nightly/reports/comprehensive

Comprehensive nightly report

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/evaluations/analytics/performance

Evaluation performance analytics

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/chat/completion

===== CHAT COMPLETION ENDPOINT WITH JAILBREAK DETECTION =====

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/security/jailbreak-analytics

===== SECURITY ANALYTICS ENDPOINTS =====

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/security/conversation-analysis/:conversationId

GET operation for /v1/security/conversation-analysis/:conversationId

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

### GET /v1/security/alerts

GET operation for /v1/security/alerts

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/security/defense-effectiveness

GET operation for /v1/security/defense-effectiveness

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tracing/llm-call

=== Distributed Tracing Endpoints for LLM and TTS ===

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/tracing/tts-call

POST operation for /v1/tracing/tts-call

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/personas/policy-templates

Get persona policy templates

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/personas/boundary-check

Check persona boundaries

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/safety/escalate

Safety escalation endpoint

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/personas/safety-validation

Persona safety validation

**Tags**: ai

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/index/documents

Document indexing endpoints

**Tags**: rag

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/retrieve

Retrieval endpoints

**Tags**: rag

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/citations/extract

Citation endpoints

**Tags**: rag

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### POST /v1/guardrails/validate

Guardrails endpoints

**Tags**: rag

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/indices

Index management endpoints

**Tags**: rag

**Responses**:

- 200: Success
- 400: Bad Request
- 500: Internal Server Error

### GET /v1/indices/:indexName/stats

GET operation for /v1/indices/:indexName/stats

**Tags**: rag

**Responses**:

- 200: Success
- 400: Bad Request
- 404: Resource not found
- 500: Internal Server Error

---

_Generated on 2025-09-25T20:56:44.220Z by OpenAPI automation system_
