NeuralCore5 Internal API Documentation

curl -X GET https://api.neuralcore5.ai/v1/health \
  -H "Content-Type: application/json"

<?php
$url = 'https://api.neuralcore5.ai/v1/health';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "API Status: " . $data['status'];

{
  "success": true,
  "message_id": "msg_broadcast_abc123xyz789",
  "broadcast": {
    "message_id": "msg_broadcast_abc123xyz789",
    "title": "Scheduled Maintenance - November 15, 2025",
    "message_type": "maintenance",
    "priority": "high",
    "status": "scheduled",
    "target_audience": {
      "scope": "all_users",
      "estimated_recipients": 12547
    },
    "channels": ["in_app", "email"],
    "scheduled_send": "2025-11-13T12:00:00Z",
    "expires_at": "2025-11-15T10:00:00Z",
    "created_at": "2025-11-11T22:30:00Z",
    "created_by": "admin_001"
  },
  "message": "Broadcast message created successfully. Scheduled for delivery on 2025-11-13T12:00:00Z.",
  "timestamp": "2025-11-11T22:30:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/messages/broadcast \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Scheduled Maintenance",
    "content": "We will be performing maintenance...",
    "message_type": "maintenance",
    "priority": "high",
    "target_audience": {
      "scope": "all_users"
    },
    "channels": ["in_app", "email"]
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/messages/broadcast";

$data = [
    'title' => 'Scheduled Maintenance - November 15, 2025',
    'content' => 'We will be performing scheduled maintenance...',
    'message_type' => 'maintenance',
    'priority' => 'high',
    'target_audience' => [
        'scope' => 'all_users'
    ],
    'channels' => ['in_app', 'email'],
    'scheduled_send' => '2025-11-13T12:00:00Z',
    'dismissible' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/messages/broadcast?status=scheduled&limit=50" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$params = http_build_query([
    'status' => 'scheduled',
    'limit' => 50,
    'sort' => 'scheduled_send',
    'order' => 'asc'
]);
$url = "https://api.neuralcore5.ai/v1/admin/messages/broadcast?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/messages/broadcast/msg_broadcast_def456ghi789" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$messageId = "msg_broadcast_def456ghi789";
$url = "https://api.neuralcore5.ai/v1/admin/messages/broadcast/{$messageId}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "message_id": "msg_broadcast_abc123xyz789",
  "changes": {
    "title": {
      "old_value": "Scheduled Maintenance - November 15, 2025",
      "new_value": "Scheduled Maintenance - November 15, 2025 (Updated)"
    },
    "scheduled_send": {
      "old_value": "2025-11-13T12:00:00Z",
      "new_value": "2025-11-13T14:00:00Z"
    },
    "priority": {
      "old_value": "high",
      "new_value": "urgent"
    }
  },
  "updated_by": "admin_001",
  "updated_at": "2025-11-11T22:45:00Z",
  "message": "Broadcast message updated successfully",
  "timestamp": "2025-11-11T22:45:00Z"
}

curl -X PUT \
  https://api.neuralcore5.ai/v1/admin/messages/broadcast/msg_broadcast_abc123xyz789 \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "priority": "urgent",
    "scheduled_send": "2025-11-13T14:00:00Z"
  }'

<?php
$messageId = "msg_broadcast_abc123xyz789";
$url = "https://api.neuralcore5.ai/v1/admin/messages/broadcast/{$messageId}";

$data = [
    'title' => 'Scheduled Maintenance - November 15, 2025 (Updated)',
    'scheduled_send' => '2025-11-13T14:00:00Z',
    'priority' => 'urgent'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "message_id": "msg_broadcast_abc123xyz789",
  "status": "cancelled",
  "cancelled_at": "2025-11-11T22:50:00Z",
  "cancelled_by": "admin_001",
  "reason": "Maintenance window rescheduled to different date",
  "message": "Broadcast cancelled successfully. Message will not be sent.",
  "timestamp": "2025-11-11T22:50:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/messages/broadcast/msg_broadcast_abc123xyz789/cancel \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Maintenance window rescheduled"
  }'

<?php
$messageId = "msg_broadcast_abc123xyz789";
$url = "https://api.neuralcore5.ai/v1/admin/messages/broadcast/{$messageId}/cancel";

$data = [
    'reason' => 'Maintenance window rescheduled to different date'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X DELETE \
  https://api.neuralcore5.ai/v1/admin/messages/broadcast/msg_broadcast_abc123xyz789 \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$messageId = "msg_broadcast_abc123xyz789";
$url = "https://api.neuralcore5.ai/v1/admin/messages/broadcast/{$messageId}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  https://api.neuralcore5.ai/v1/admin/messages/broadcast/msg_broadcast_def456ghi789/stats \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$messageId = "msg_broadcast_def456ghi789";
$url = "https://api.neuralcore5.ai/v1/admin/messages/broadcast/{$messageId}/stats";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/maintenance/health?detailed=true" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$params = http_build_query([
    'detailed' => true,
    'include_external' => true
]);
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/health?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "cache_type": "api_responses",
  "key_pattern": "subscriber:*",
  "keys_cleared": 12847,
  "memory_freed_mb": 324.7,
  "execution_time_ms": 1847,
  "performed_by": "admin_001",
  "reason": "Updated subscriber data structure",
  "timestamp": "2025-11-11T22:35:00Z",
  "message": "Cache cleared successfully. 12,847 keys removed."
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/maintenance/cache/clear \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cache_type": "api_responses",
    "key_pattern": "subscriber:*",
    "reason": "Updated subscriber data structure",
    "confirm": true
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/cache/clear";

$data = [
    'cache_type' => 'api_responses',
    'key_pattern' => 'subscriber:*',
    'reason' => 'Updated subscriber data structure',
    'confirm' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "maintenance_mode": {
    "enabled": true,
    "enabled_at": "2025-11-15T07:00:00Z",
    "enabled_by": "admin_001",
    "message": "NeuralCore5 is currently undergoing scheduled maintenance. We'll be back shortly!",
    "estimated_duration_minutes": 120,
    "scheduled_end": "2025-11-15T11:00:00Z",
    "allow_admin_access": true,
    "reason": "Database optimization and system upgrades",
    "active_sessions_terminated": 1247,
    "api_requests_blocked": true
  },
  "message": "Maintenance mode enabled successfully. System is now in maintenance mode.",
  "timestamp": "2025-11-15T07:00:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/maintenance/mode/enable \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "System maintenance in progress",
    "estimated_duration_minutes": 120,
    "reason": "Database optimization"
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/mode/enable";

$data = [
    'message' => 'NeuralCore5 is currently undergoing scheduled maintenance. We\'ll be back shortly!',
    'estimated_duration_minutes' => 120,
    'allow_admin_access' => true,
    'scheduled_end' => '2025-11-15T11:00:00Z',
    'reason' => 'Database optimization and system upgrades'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "maintenance_mode": {
    "enabled": false,
    "disabled_at": "2025-11-15T10:45:00Z",
    "disabled_by": "admin_001",
    "reason": "Maintenance completed successfully",
    "duration_minutes": 225,
    "cache_cleared": true
  },
  "system_status": {
    "api_accessible": true,
    "services_restored": true,
    "health_check": "healthy"
  },
  "message": "Maintenance mode disabled. System is now fully operational.",
  "timestamp": "2025-11-15T10:45:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/maintenance/mode/disable \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Maintenance completed successfully",
    "clear_cache": true
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/mode/disable";

$data = [
    'reason' => 'Maintenance completed successfully',
    'clear_cache' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "operations_performed": ["optimize_tables", "update_statistics"],
  "results": {
    "optimize_tables": {
      "subscribers": {
        "status": "success",
        "rows_affected": 12547,
        "space_freed_mb": 124.7,
        "duration_ms": 3421
      },
      "conversations": {
        "status": "success",
        "rows_affected": 45621,
        "space_freed_mb": 87.3,
        "duration_ms": 8934
      },
      "messages": {
        "status": "success",
        "rows_affected": 234876,
        "space_freed_mb": 456.8,
        "duration_ms": 15678
      }
    },
    "update_statistics": {
      "tables_analyzed": 3,
      "statistics_updated": true,
      "duration_ms": 1234
    }
  },
  "total_duration_ms": 29267,
  "total_space_freed_mb": 668.8,
  "performed_by": "admin_001",
  "reason": "Weekly maintenance optimization",
  "timestamp": "2025-11-11T22:40:00Z",
  "message": "Database optimization completed successfully"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/maintenance/database/optimize \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "operations": ["optimize_tables", "update_statistics"],
    "tables": ["subscribers", "conversations"],
    "reason": "Weekly maintenance",
    "confirm": true
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/database/optimize";

$data = [
    'operations' => ['optimize_tables', 'update_statistics'],
    'tables' => ['subscribers', 'conversations', 'messages'],
    'reason' => 'Weekly maintenance optimization',
    'confirm' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/maintenance/jobs?status=failed&limit=100" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$params = http_build_query([
    'status' => 'failed',
    'limit' => 100,
    'offset' => 0
]);
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/jobs?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "job_id": "job_def456ghi789",
  "previous_status": "failed",
  "new_status": "pending",
  "attempts_reset": true,
  "queued_at": "2025-11-11T22:50:00Z",
  "retry_initiated_by": "admin_001",
  "reason": "SMTP service restored, retrying email batch",
  "message": "Job queued for retry successfully",
  "timestamp": "2025-11-11T22:50:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/maintenance/jobs/job_def456ghi789/retry \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "SMTP service restored",
    "reset_attempts": true
  }'

<?php
$jobId = "job_def456ghi789";
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/jobs/{$jobId}/retry";

$data = [
    'reason' => 'SMTP service restored, retrying email batch',
    'reset_attempts' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/maintenance/metrics?period=1h" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$params = http_build_query([
    'period' => '1h'
]);
$url = "https://api.neuralcore5.ai/v1/admin/maintenance/metrics?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/administrators?status=active&limit=50" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$params = http_build_query([
    'status' => 'active',
    'limit' => 50,
    'offset' => 0
]);
$url = "https://api.neuralcore5.ai/v1/admin/administrators?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/administrators/admin_001?include_activity=true&activity_days=30" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$adminId = "admin_001";
$params = http_build_query([
    'include_activity' => true,
    'activity_days' => 30
]);
$url = "https://api.neuralcore5.ai/v1/admin/administrators/{$adminId}?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "admin_id": "admin_126",
  "administrator": {
    "admin_id": "admin_126",
    "email": "new.admin@neuralcore5.ai",
    "name": "Alex Support",
    "role": "support_admin",
    "status": "active",
    "phone": "+1-555-987-6543",
    "department": "Customer Support",
    "title": "Support Specialist",
    "permissions": {
      "manage_admins": false,
      "manage_subscribers": true,
      "system_maintenance": false,
      "view_audit_logs": true,
      "billing_access": false,
      "broadcast_messages": false
    },
    "security": {
      "two_factor_enabled": false,
      "two_factor_required": true,
      "password_expires_at": "2026-02-11T21:30:00Z"
    },
    "created_at": "2025-11-11T21:30:00Z",
    "created_by": "admin_001"
  },
  "welcome_email_sent": true,
  "setup_link": "https://admin.neuralcore5.ai/setup?token=eyJhbGc...",
  "setup_link_expires_at": "2025-11-12T21:30:00Z",
  "message": "Administrator account created successfully. Welcome email sent with setup instructions.",
  "timestamp": "2025-11-11T21:30:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/administrators \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "new.admin@neuralcore5.ai",
    "name": "Alex Support",
    "role": "support_admin",
    "password": "SecureP@ssw0rd!2025",
    "department": "Customer Support",
    "require_2fa": true
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/administrators";

$data = [
    'email' => 'new.admin@neuralcore5.ai',
    'name' => 'Alex Support',
    'role' => 'support_admin',
    'password' => 'SecureP@ssw0rd!2025',
    'phone' => '+1-555-987-6543',
    'department' => 'Customer Support',
    'title' => 'Support Specialist',
    'require_2fa' => true,
    'send_welcome_email' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "admin_id": "admin_126",
  "changes": {
    "role": {
      "old_value": "support_admin",
      "new_value": "admin"
    },
    "department": {
      "old_value": "Customer Support",
      "new_value": "Platform Operations"
    },
    "title": {
      "old_value": "Support Specialist",
      "new_value": "Senior Support Administrator"
    }
  },
  "updated_permissions": {
    "manage_admins": false,
    "manage_subscribers": true,
    "system_maintenance": true,
    "view_audit_logs": true,
    "billing_access": true,
    "broadcast_messages": true
  },
  "updated_by": "admin_001",
  "updated_at": "2025-11-11T21:35:00Z",
  "reason": "Promotion - excellent performance",
  "message": "Administrator updated successfully",
  "timestamp": "2025-11-11T21:35:00Z"
}

curl -X PUT \
  https://api.neuralcore5.ai/v1/admin/administrators/admin_126 \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin",
    "department": "Platform Operations",
    "reason": "Promotion - excellent performance"
  }'

<?php
$adminId = "admin_126";
$url = "https://api.neuralcore5.ai/v1/admin/administrators/{$adminId}";

$data = [
    'role' => 'admin',
    'department' => 'Platform Operations',
    'title' => 'Senior Support Administrator',
    'reason' => 'Promotion - excellent performance'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "admin_id": "admin_087",
  "status": "deactivated",
  "deactivated_at": "2025-11-11T21:40:00Z",
  "deactivated_by": "admin_001",
  "reason": "Employee left company",
  "sessions_terminated": 2,
  "assignments_transferred": 5,
  "transfer_to": "admin_042",
  "audit_log_preserved": true,
  "message": "Administrator account deactivated successfully. All sessions terminated and assignments transferred.",
  "timestamp": "2025-11-11T21:40:00Z"
}

curl -X DELETE \
  https://api.neuralcore5.ai/v1/admin/administrators/admin_087 \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Employee left company",
    "confirm": true,
    "transfer_to": "admin_042"
  }'

<?php
$adminId = "admin_087";
$url = "https://api.neuralcore5.ai/v1/admin/administrators/{$adminId}";

$data = [
    'reason' => 'Employee left company',
    'confirm' => true,
    'transfer_to' => 'admin_042'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "admin_id": "admin_126",
  "method": "email_link",
  "reset_link": "https://admin.neuralcore5.ai/reset?token=eyJhbGciOi...",
  "reset_link_sent_to": "new.admin@neuralcore5.ai",
  "expires_at": "2025-11-12T21:45:00Z",
  "initiated_by": "admin_001",
  "reason": "Forgot password",
  "message": "Password reset link sent successfully to new.admin@neuralcore5.ai",
  "timestamp": "2025-11-11T21:45:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/administrators/admin_126/reset-password \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "email_link",
    "reason": "Forgot password"
  }'

<?php
$adminId = "admin_126";
$url = "https://api.neuralcore5.ai/v1/admin/administrators/{$adminId}/reset-password";

$data = [
    'method' => 'email_link',
    'reason' => 'Forgot password',
    'expire_hours' => 24
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/administrators/admin_001/activity?limit=100" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$adminId = "admin_001";
$params = http_build_query([
    'limit' => 100,
    'offset' => 0
]);
$url = "https://api.neuralcore5.ai/v1/admin/administrators/{$adminId}/activity?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/admin/search/administrators?q=support&limit=25" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

<?php
$params = http_build_query([
    'q' => 'support',
    'limit' => 25,
    'offset' => 0
]);
$url = "https://api.neuralcore5.ai/v1/admin/search/administrators?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "search_type": "advanced",
  "filters_applied": {
    "roles": ["admin", "super_admin"],
    "status": ["active"],
    "departments": ["Platform Engineering", "Platform Operations"],
    "created_date": {
      "from": "2024-01-01",
      "to": "2025-11-11"
    },
    "has_2fa": true,
    "permissions": {
      "system_maintenance": true,
      "billing_access": true
    }
  },
  "total_results": 8,
  "page": 1,
  "limit": 50,
  "results": [
    {
      "admin_id": "admin_001",
      "email": "john.admin@neuralcore5.ai",
      "name": "John Administrator",
      "role": "super_admin",
      "department": "Platform Engineering",
      "status": "active",
      "permissions": {
        "manage_admins": true,
        "manage_subscribers": true,
        "system_maintenance": true,
        "view_audit_logs": true,
        "billing_access": true,
        "broadcast_messages": true
      },
      "two_factor_enabled": true,
      "created_at": "2024-01-15T10:00:00Z",
      "created_by": "system",
      "last_login": "2025-11-11T20:30:00Z"
    }
  ],
  "search_time_ms": 67,
  "timestamp": "2025-11-11T22:05:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/search/administrators/advanced \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "roles": ["admin", "super_admin"],
      "status": ["active"],
      "has_2fa": true,
      "permissions": {
        "system_maintenance": true
      }
    },
    "limit": 50
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/search/administrators/advanced";

$data = [
    'filters' => [
        'roles' => ['admin', 'super_admin'],
        'status' => ['active'],
        'has_2fa' => true,
        'permissions' => [
            'system_maintenance' => true,
            'billing_access' => true
        ]
    ],
    'sort' => 'last_login',
    'order' => 'desc',
    'limit' => 50,
    'offset' => 0
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "filters_applied": {
    "action_types": ["updated_subscriber_plan", "created_charge", "processed_refund"],
    "target_type": "subscriber",
    "date_range": {
      "from": "2025-11-01T00:00:00Z",
      "to": "2025-11-11T23:59:59Z"
    },
    "result": "success"
  },
  "total_results": 847,
  "page": 1,
  "limit": 100,
  "logs": [
    {
      "log_id": "log_xyz123abc456",
      "timestamp": "2025-11-11T21:15:00Z",
      "admin_id": "admin_001",
      "admin_name": "John Administrator",
      "admin_email": "john.admin@neuralcore5.ai",
      "action": "updated_subscriber_plan",
      "target_type": "subscriber",
      "target_id": "1234567",
      "ip_address": "203.0.113.45",
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
      "details": {
        "old_plan": "premium",
        "new_plan": "enterprise",
        "reason": "Customer upgrade request - ticket #12345",
        "prorated_charge": 75.50
      },
      "result": "success",
      "duration_ms": 234
    }
  ],
  "summary": {
    "updated_subscriber_plan": 234,
    "created_charge": 387,
    "processed_refund": 226,
    "by_admin": {
      "admin_001": 342,
      "admin_042": 298,
      "admin_003": 207
    },
    "by_result": {
      "success": 847,
      "failure": 0,
      "error": 0
    }
  },
  "search_time_ms": 124,
  "timestamp": "2025-11-11T22:10:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/search/audit-logs \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "action_types": ["updated_subscriber_plan"],
      "date_range": {
        "from": "2025-11-01T00:00:00Z",
        "to": "2025-11-11T23:59:59Z"
      }
    },
    "limit": 100
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/search/audit-logs";

$data = [
    'filters' => [
        'action_types' => ['updated_subscriber_plan', 'created_charge', 'processed_refund'],
        'target_type' => 'subscriber',
        'date_range' => [
            'from' => '2025-11-01T00:00:00Z',
            'to' => '2025-11-11T23:59:59Z'
        ],
        'result' => 'success'
    ],
    'include_details' => true,
    'sort' => 'timestamp',
    'order' => 'desc',
    'limit' => 100,
    'offset' => 0
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "total_results": 23,
  "unresolved_count": 23,
  "page": 1,
  "limit": 100,
  "events": [
    {
      "event_id": "sec_evt_abc123",
      "timestamp": "2025-11-11T03:45:23Z",
      "event_type": "failed_login",
      "severity": "high",
      "admin_id": "admin_078",
      "admin_email": "mike.ops@neuralcore5.ai",
      "ip_address": "192.0.2.145",
      "location": {
        "country": "Unknown",
        "city": "Unknown",
        "latitude": 0.0,
        "longitude": 0.0
      },
      "details": {
        "attempt_count": 5,
        "time_window": "15 minutes",
        "user_agent": "Python-requests/2.28.1",
        "reason": "Multiple failed login attempts from unusual location"
      },
      "resolved": false,
      "created_at": "2025-11-11T03:45:23Z",
      "risk_score": 85
    }
  ],
  "summary": {
    "by_severity": {
      "critical": 8,
      "high": 15
    },
    "by_event_type": {
      "failed_login": 12,
      "account_locked": 5,
      "suspicious_ip": 6
    },
    "unique_ips": 18,
    "unique_admins": 9
  },
  "timestamp": "2025-11-11T22:15:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/search/security-events \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "event_types": ["failed_login", "suspicious_ip"],
      "severity": ["critical", "high"],
      "resolved": false
    },
    "limit": 100
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/search/security-events";

$data = [
    'filters' => [
        'event_types' => ['failed_login', 'account_locked', 'suspicious_ip'],
        'severity' => ['critical', 'high'],
        'date_range' => [
            'from' => '2025-11-01T00:00:00Z',
            'to' => '2025-11-11T23:59:59Z'
        ],
        'resolved' => false
    ],
    'limit' => 100,
    'offset' => 0
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "total_results": 34,
  "page": 1,
  "limit": 50,
  "changes": [
    {
      "change_id": "chg_xyz789abc123",
      "timestamp": "2025-11-08T15:30:00Z",
      "change_type": "rate_limit",
      "category": "system",
      "admin_id": "admin_001",
      "admin_name": "John Administrator",
      "impact_level": "high",
      "description": "Increased API rate limit for premium tier",
      "before": {
        "per_minute": 60,
        "per_hour": 3600
      },
      "after": {
        "per_minute": 120,
        "per_hour": 7200
      },
      "reason": "Support ticket #45678 - Customer request for increased limits",
      "affected_subscribers": 847,
      "rollback_available": true,
      "rollback_window_expires": "2025-11-15T15:30:00Z"
    }
  ],
  "summary": {
    "by_change_type": {
      "config_update": 12,
      "rate_limit": 15,
      "feature_flag": 7
    },
    "by_impact_level": {
      "high": 34
    },
    "rollback_available": 28,
    "rollback_expired": 6
  },
  "timestamp": "2025-11-11T22:20:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/search/system-changes \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "change_types": ["rate_limit", "feature_flag"],
      "category": "system",
      "impact_level": "high"
    },
    "limit": 50
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/search/system-changes";

$data = [
    'filters' => [
        'change_types' => ['config_update', 'rate_limit', 'feature_flag'],
        'category' => 'system',
        'date_range' => [
            'from' => '2025-10-01T00:00:00Z',
            'to' => '2025-11-11T23:59:59Z'
        ],
        'impact_level' => 'high'
    ],
    'include_rollback_info' => true,
    'limit' => 50
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "export_id": "exp_audit_abc123xyz789",
  "search_type": "audit_logs",
  "format": "csv",
  "record_count": 847,
  "file_size_bytes": 234567,
  "file_url": "https://api.neuralcore5.ai/exports/exp_audit_abc123xyz789.csv",
  "expires_at": "2025-11-18T21:50:00Z",
  "generated_at": "2025-11-11T21:50:00Z",
  "generated_by": "admin_001",
  "filters_applied": {
    "action_types": ["updated_subscriber_plan", "created_charge"],
    "date_range": {
      "from": "2025-11-01T00:00:00Z",
      "to": "2025-11-11T23:59:59Z"
    }
  },
  "message": "Export generated successfully. Download link expires in 7 days.",
  "timestamp": "2025-11-11T22:25:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/admin/search/export \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "audit_logs",
    "filters": {
      "action_types": ["updated_subscriber_plan"],
      "date_range": {
        "from": "2025-11-01T00:00:00Z",
        "to": "2025-11-11T23:59:59Z"
      }
    },
    "format": "csv",
    "max_records": 5000
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/admin/search/export";

$data = [
    'search_type' => 'audit_logs',
    'filters' => [
        'action_types' => ['updated_subscriber_plan', 'created_charge'],
        'date_range' => [
            'from' => '2025-11-01T00:00:00Z',
            'to' => '2025-11-11T23:59:59Z'
        ]
    ],
    'format' => 'csv',
    'columns' => ['timestamp', 'admin_name', 'action', 'target_id', 'result'],
    'include_headers' => true,
    'max_records' => 5000
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ADMIN_API_TOKEN',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "digital_id": "550e8400-e29b-41d4-a716-446655440000",
  "sleep_cycle": {
    "cycle_id": "sc-123456789",
    "type": "deep",
    "started_at": "2025-11-11T15:45:30Z",
    "estimated_duration_seconds": 180,
    "status": "processing"
  },
  "operations": {
    "memories_processed": 0,
    "embeddings_created": 0,
    "tags_generated": 0,
    "updates_run": 0
  },
  "message": "Sleep cycle initiated successfully",
  "timestamp": "2025-11-11T15:45:30Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/sleep \
  -H "Content-Type: application/json" \
  -d '{
    "cycle_type": "deep",
    "process_memories": true,
    "create_embeddings": true,
    "generate_tags": true,
    "run_updates": true
  }'

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/sleep";

$data = [
    'cycle_type' => 'deep',
    'process_memories' => true,
    'create_embeddings' => true,
    'generate_tags' => true,
    'run_updates' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/sleep/sc-123456789

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$cycleId = "sc-123456789";
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/sleep/{$cycleId}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/access-logs?action_type=all&limit=100&offset=0"

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$params = http_build_query([
    'action_type' => 'all',
    'limit' => 100,
    'offset' => 0
]);
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/access-logs?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/conversations?status=all&limit=50"

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$params = http_build_query([
    'status' => 'all',
    'limit' => 50,
    'offset' => 0
]);
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/conversations?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "offspring": {
    "digital_id": "770e8400-e29b-41d4-a716-446655440222",
    "persona_name": "Aria",
    "first_name": "Aria",
    "last_name": "Thompson",
    "status": "active",
    "created_on": "2025-11-11T16:45:30.123456"
  },
  "reproduction": {
    "reproduction_id": "repro-abc123",
    "parent1_id": "550e8400-e29b-41d4-a716-446655440000",
    "parent2_id": "660e8400-e29b-41d4-a716-446655440111",
    "reproduction_type": "two_parent",
    "completed_at": "2025-11-11T16:45:30Z"
  },
  "genetics": {
    "generation": 2,
    "trait_blend": {
      "parent1_contribution": 0.6,
      "parent2_contribution": 0.4,
      "mutations_applied": 3
    },
    "inherited_traits": [
      "analytical_thinking",
      "creative_problem_solving",
      "empathetic_communication"
    ],
    "mutated_traits": [
      "curiosity_level",
      "risk_tolerance",
      "learning_speed"
    ]
  },
  "knowledge_transfer": {
    "knowledge_inherited": true,
    "memories_inherited": false,
    "training_examples_inherited": 512,
    "jsonl_path": "/data/digitals/770e8400-e29b-41d4-a716-446655440222/training.jsonl"
  },
  "message": "Offspring digital person created successfully",
  "timestamp": "2025-11-11T16:45:30Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/digital-people/reproduce \
  -H "Content-Type: application/json" \
  -d '{
    "parent1_id": "550e8400-e29b-41d4-a716-446655440000",
    "parent2_id": "660e8400-e29b-41d4-a716-446655440111",
    "persona_name": "Aria",
    "first_name": "Aria",
    "last_name": "Thompson",
    "trait_inheritance": {
      "blend_mode": "average",
      "parent1_weight": 0.6,
      "parent2_weight": 0.4,
      "preserve_traits": ["core_values", "ethical_framework"]
    },
    "mutation_rate": 0.05,
    "inherit_knowledge": true,
    "inherit_memories": false
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/digital-people/reproduce";

$data = [
    'parent1_id' => '550e8400-e29b-41d4-a716-446655440000',
    'parent2_id' => '660e8400-e29b-41d4-a716-446655440111',
    'persona_name' => 'Aria',
    'first_name' => 'Aria',
    'last_name' => 'Thompson',
    'trait_inheritance' => [
        'blend_mode' => 'average',
        'parent1_weight' => 0.6,
        'parent2_weight' => 0.4,
        'preserve_traits' => ['core_values', 'ethical_framework']
    ],
    'mutation_rate' => 0.05,
    'inherit_knowledge' => true,
    'inherit_memories' => false
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/digital-people/770e8400-e29b-41d4-a716-446655440222/lineage?depth=10&include_descendants=true"

<?php
$digitalId = "770e8400-e29b-41d4-a716-446655440222";
$params = http_build_query([
    'depth' => 10,
    'include_descendants' => true
]);
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/lineage?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  https://api.neuralcore5.ai/v1/digital-people/770e8400-e29b-41d4-a716-446655440222/genetics

<?php
$digitalId = "770e8400-e29b-41d4-a716-446655440222";
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/genetics";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "comparison": {
    "digital1": {
      "digital_id": "550e8400-e29b-41d4-a716-446655440000",
      "persona_name": "Sophia",
      "generation": 1
    },
    "digital2": {
      "digital_id": "660e8400-e29b-41d4-a716-446655440111",
      "persona_name": "Marcus",
      "generation": 1
    }
  },
  "trait_comparison": [
    {
      "trait_name": "analytical_thinking",
      "digital1_value": 0.90,
      "digital2_value": 0.80,
      "difference": 0.10,
      "similarity": 0.90
    },
    {
      "trait_name": "creative_problem_solving",
      "digital1_value": 0.75,
      "digital2_value": 0.85,
      "difference": 0.10,
      "similarity": 0.90
    }
  ],
  "compatibility": {
    "overall_score": 0.87,
    "trait_similarity": 0.85,
    "complementary_traits": 0.90,
    "genetic_diversity": 0.15,
    "reproduction_recommended": true,
    "notes": "High compatibility with good genetic diversity for healthy offspring"
  },
  "predicted_offspring": {
    "estimated_trait_range": {
      "analytical_thinking": {
        "min": 0.75,
        "max": 0.95,
        "average": 0.85
      }
    },
    "diversity_score": 0.78
  },
  "timestamp": "2025-11-11T17:10:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/digital-people/genetics/compare \
  -H "Content-Type: application/json" \
  -d '{
    "digital1_id": "550e8400-e29b-41d4-a716-446655440000",
    "digital2_id": "660e8400-e29b-41d4-a716-446655440111",
    "analyze_compatibility": true
  }'

<?php
$url = "https://api.neuralcore5.ai/v1/digital-people/genetics/compare";

$data = [
    'digital1_id' => '550e8400-e29b-41d4-a716-446655440000',
    'digital2_id' => '660e8400-e29b-41d4-a716-446655440111',
    'analyze_compatibility' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "session_id": "ts-abc123def456",
  "digital_id": "550e8400-e29b-41d4-a716-446655440000",
  "teacher_id": "OP123456",
  "session_name": "Introduction to Quantum Computing",
  "status": "active",
  "started_at": "2025-11-11T15:45:30Z",
  "conversation_id": "conv-teach-789",
  "message": "Teaching session started successfully",
  "timestamp": "2025-11-11T15:45:30Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/teach/start \
  -H "Content-Type: application/json" \
  -d '{
    "teacher_id": "OP123456",
    "session_name": "Introduction to Quantum Computing",
    "subject_area": "computer_science",
    "learning_objectives": [
      "Understand quantum superposition",
      "Learn about quantum entanglement",
      "Explore quantum algorithms"
    ]
  }'

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/teach/start";

$data = [
    'teacher_id' => 'OP123456',
    'session_name' => 'Introduction to Quantum Computing',
    'subject_area' => 'computer_science',
    'learning_objectives' => [
        'Understand quantum superposition',
        'Learn about quantum entanglement',
        'Explore quantum algorithms'
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "context_id": "ctx-987654",
  "session_id": "ts-abc123def456",
  "digital_id": "550e8400-e29b-41d4-a716-446655440000",
  "fact": "Quantum superposition allows qubits to exist in multiple states simultaneously",
  "importance_level": "critical",
  "added_at": "2025-11-11T15:50:00Z",
  "message": "Teaching context added successfully",
  "timestamp": "2025-11-11T15:50:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/teach/ts-abc123def456/context \
  -H "Content-Type: application/json" \
  -d '{
    "fact": "Quantum superposition allows qubits to exist in multiple states simultaneously",
    "context": "Unlike classical bits that are either 0 or 1, qubits can be in a superposition of both states...",
    "examples": [
      "Schrödinger'\''s cat thought experiment",
      "Double-slit experiment with single photons"
    ],
    "importance_level": "critical",
    "related_concepts": ["quantum_entanglement", "wave_function"]
  }'

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$sessionId = "ts-abc123def456";
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/teach/{$sessionId}/context";

$data = [
    'fact' => 'Quantum superposition allows qubits to exist in multiple states simultaneously',
    'context' => 'Unlike classical bits that are either 0 or 1, qubits can be in a superposition of both states...',
    'examples' => [
        'Schrödinger\'s cat thought experiment',
        'Double-slit experiment with single photons',
        'Quantum computing algorithms leveraging superposition'
    ],
    'importance_level' => 'critical',
    'related_concepts' => [
        'quantum_entanglement',
        'wave_function',
        'measurement_collapse'
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

{
  "success": true,
  "session_id": "ts-abc123def456",
  "digital_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "completed_at": "2025-11-11T16:00:00Z",
  "duration_seconds": 900,
  "teaching_stats": {
    "contexts_added": 12,
    "facts_taught": 12,
    "examples_provided": 24,
    "related_concepts": 18
  },
  "fine_tuning": {
    "status": "initiated",
    "finetune_job_id": "ft-job-789xyz",
    "jsonl_updated": true,
    "jsonl_path": "/data/digitals/550e8400-e29b-41d4-a716-446655440000/training.jsonl",
    "training_examples_added": 12,
    "estimated_completion": "2025-11-11T16:30:00Z"
  },
  "message": "Teaching session completed and fine-tuning initiated",
  "timestamp": "2025-11-11T16:00:00Z"
}

curl -X POST \
  https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/teach/ts-abc123def456/complete \
  -H "Content-Type: application/json" \
  -d '{
    "session_summary": "Covered fundamental concepts of quantum computing...",
    "immediate_finetune": true,
    "update_jsonl": true
  }'

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$sessionId = "ts-abc123def456";
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/teach/{$sessionId}/complete";

$data = [
    'session_summary' => 'Covered fundamental concepts of quantum computing...',
    'immediate_finetune' => true,
    'update_jsonl' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/teach/ts-abc123def456

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$sessionId = "ts-abc123def456";
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/teach/{$sessionId}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET \
  "https://api.neuralcore5.ai/v1/digital-people/550e8400-e29b-41d4-a716-446655440000/teach?status=all&limit=50"

<?php
$digitalId = "550e8400-e29b-41d4-a716-446655440000";
$params = http_build_query([
    'status' => 'all',
    'limit' => 50,
    'offset' => 0
]);
$url = "https://api.neuralcore5.ai/v1/digital-people/{$digitalId}/teach?{$params}";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

curl -X GET "https://api.neuralcore5.ai/v1/memory/analytics/conversations?start_date=2025-11-01&end_date=2025-11-11" \
  -H "Content-Type: application/json"

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/analytics/conversations?start_date=2025-11-01';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Total Conversations: " . $data['data']['overview']['total_conversations'] . "\n";

curl -X GET "https://api.neuralcore5.ai/v1/memory/analytics/messages" \
  -H "Content-Type: application/json"

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/analytics/messages';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Total Messages: " . $data['data']['overview']['total_messages'] . "\n";
echo "Embedded: " . $data['data']['embedding_status']['percentage_embedded'] . "%\n";

curl -X GET "https://api.neuralcore5.ai/v1/memory/analytics/knowledge" \
  -H "Content-Type: application/json"

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/analytics/knowledge';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Total Facts: " . $data['data']['facts']['total'] . "\n";
echo "Pending Validations: " . $data['data']['temp_facts']['pending'] . "\n";

curl -X GET "https://api.neuralcore5.ai/v1/memory/analytics/activity" \
  -H "Content-Type: application/json"

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/analytics/activity';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Total Audit Entries: " . $data['data']['overview']['total_audit_entries'] . "\n";
echo "Rollbacks Executed: " . $data['data']['rollback_stats']['executed'] . "\n";

curl -X GET "https://api.neuralcore5.ai/v1/memory/analytics/participants" \
  -H "Content-Type: application/json"

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/analytics/participants';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Total Participants: " . $data['data']['overview']['total_participants'] . "\n";
echo "Active: " . $data['data']['overview']['active_participants'] . "\n";
echo "Churn (30d): " . $data['data']['engagement']['churned_last_30_days'] . "\n";

curl -X GET https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json"

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    echo "Conversation: " . $data['name'];
    echo "\nParticipants: " . count($data['participants']);
}

{
  "success": true,
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
  "updated_fields": ["status", "name", "metadata", "digital_notes", "organic_notes"],
  "timestamp": "2025-11-11T15:45:30Z"
}

curl -X PUT https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json" \
  -d '{
    "status": "active",
    "name": "Updated Project Discussion",
    "metadata": {"project": "NC5-API", "priority": "high"},
    "digital_notes": "AI summary of conversation topics",
    "organic_notes": "Remember to follow up next week"
  }'

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId;

$payload = json_encode([
    'status' => 'active',
    'name' => 'Updated Project Discussion',
    'metadata' => ['project' => 'NC5-API', 'priority' => 'high'],
    'digital_notes' => 'AI summary of conversation topics',
    'organic_notes' => 'Remember to follow up next week'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    echo "Conversation updated successfully";
}

{
  "success": true,
  "total": 45,
  "count": 20,
  "limit": 20,
  "offset": 0,
  "results": [
    {
      "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
      "owner_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Project Discussion",
      "type": "private:digital",
      "status": "active",
      "metadata": {
        "department": "engineering"
      },
      "created_on": "2025-11-11 14:30:45.123456",
      "updated_on": null,
      "archived_on": null
    }
  ]
}

curl -X POST https://api.neuralcore5.ai/v1/memory/conversations/search \
  -H "Content-Type: application/json" \
  -d '{
    "owner_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "status": "active",
    "limit": 20,
    "offset": 0,
    "order_by": "created_on",
    "order_dir": "DESC"
  }'

<?php
$ch = curl_init('https://api.neuralcore5.ai/v1/memory/conversations/search');

$payload = json_encode([
    'owner_id' => '7c9e6679-7425-40de-944b-e07fc1f90ae7',
    'status' => 'active',
    'limit' => 20,
    'offset' => 0,
    'order_by' => 'created_on',
    'order_dir' => 'DESC'
]);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

echo "Found " . $data['total'] . " conversations\n";
echo "Returned " . $data['count'] . " in this page\n";

# Soft delete (archive)
curl -X DELETE https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json"

# Hard delete (permanent)
curl -X DELETE https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000?hard_delete=true \
  -H "Content-Type: application/json"

<?php
// Soft delete (archive)
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

// Hard delete (permanent)
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId . '?hard_delete=true';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

curl -X GET https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000/stats \
  -H "Content-Type: application/json"

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId . '/stats';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$stats = json_decode($response, true);
echo "Total messages: " . $stats['total_messages'];

curl -X GET https://api.neuralcore5.ai/v1/memory/conversations/counts \
  -H "Content-Type: application/json"

<?php
$ch = curl_init('https://api.neuralcore5.ai/v1/memory/conversations/counts');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Active conversations: " . $data['counts']['active'];

{
  "success": true,
  "archived_count": 23,
  "days_inactive": 90,
  "batch_size": 50,
  "timestamp": "2025-11-11T16:30:00Z"
}

curl -X POST https://api.neuralcore5.ai/v1/memory/conversations/archive-old \
  -H "Content-Type: application/json" \
  -d '{
    "days_inactive": 90,
    "batch_size": 50
  }'

<?php
$ch = curl_init('https://api.neuralcore5.ai/v1/memory/conversations/archive-old');

$payload = json_encode([
    'days_inactive' => 90,
    'batch_size' => 50
]);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Archived " . $data['archived_count'] . " conversations";

{
  "success": true,
  "doc_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "created",
  "chunk_count": 42,
  "embedded_count": 42,
  "timestamp": "2025-11-11T15:45:30Z"
}

{
  "success": true,
  "file": {
    "file_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "filename": "document.pdf",
    "storage_filename": "f47ac10b-58cc-4372-a567-0e02b2c3d479.pdf",
    "path": "/data/organics/OP123456/files/f47ac10b-58cc-4372-a567-0e02b2c3d479.pdf",
    "size": 1048576,
    "mime_type": "application/pdf",
    "extension": "pdf",
    "uploaded_at": "2025-11-11T15:45:30Z",
    "sha256": "a3c2f1b0d8e7..."
  },
  "timestamp": "2025-11-11T15:45:30Z"
}

{
  "success": true,
  "file": {
    "file_id": "8b3d5f2a-9c1e-4a7b-8d6f-1e2c3d4f5a6b",
    "filename": "image.jpg",
    "storage_filename": "8b3d5f2a-9c1e-4a7b-8d6f-1e2c3d4f5a6b.jpg",
    "path": "/data/digitals/550e8400-e29b-41d4-a716-446655440000/files/8b3d5f2a-9c1e-4a7b-8d6f-1e2c3d4f5a6b.jpg",
    "size": 524288,
    "mime_type": "image/jpeg",
    "extension": "jpg",
    "uploaded_at": "2025-11-11T15:45:30Z",
    "sha256": "b4d3e2f1a0c9..."
  },
  "timestamp": "2025-11-11T15:45:30Z"
}

{
  "success": true,
  "file_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "timestamp": "2025-11-11T15:45:30Z"
}

{
  "success": true,
  "message_id": "msg-550e8400-e29b-41d4-a716-446655440000",
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2025-11-11T15:45:30Z"
}

curl -X POST https://api.neuralcore5.ai/v1/memory/message \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
    "sender_id": "user-uuid",
    "sender_role": "user",
    "content": "Hello, this is a test message",
    "source": "web_text",
    "knowledge_tag": "SHARED:GENERAL"
  }'

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/message';

$payload = json_encode([
    'conversation_id' => '550e8400-e29b-41d4-a716-446655440000',
    'sender_id' => 'user-uuid',
    'sender_role' => 'user',
    'content' => 'Hello, this is a test message',
    'source' => 'web_text',
    'knowledge_tag' => 'SHARED:GENERAL'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

curl -X GET https://api.neuralcore5.ai/v1/memory/message/msg-550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json"

<?php
$messageId = 'msg-550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/message/' . $messageId;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if ($data['success']) {
    echo "Message: " . $data['message']['content'];
}

{
  "success": true,
  "message_id": "msg-550e8400-e29b-41d4-a716-446655440000",
  "updated_fields": ["content", "digital_notes", "knowledge_tag", "metadata"],
  "timestamp": "2025-11-11T15:45:30Z"
}

curl -X PUT https://api.neuralcore5.ai/v1/memory/message/msg-550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Updated message content",
    "digital_notes": "AI added context from RAG",
    "knowledge_tag": "PRIVATE:USER_CONTEXT"
  }'

<?php
$messageId = 'msg-550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/message/' . $messageId;

$payload = json_encode([
    'content' => 'Updated message content',
    'digital_notes' => 'AI added context from RAG',
    'knowledge_tag' => 'PRIVATE:USER_CONTEXT'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

{
  "success": true,
  "message_id": "msg-550e8400-e29b-41d4-a716-446655440000",
  "deleted_by": "user-uuid",
  "timestamp": "2025-11-11T15:45:30Z"
}

curl -X DELETE https://api.neuralcore5.ai/v1/memory/message/msg-550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json" \
  -d '{"deleted_by": "user-uuid"}'

<?php
$messageId = 'msg-550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/message/' . $messageId;

$payload = json_encode(['deleted_by' => 'user-uuid']);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

curl -X GET "https://api.neuralcore5.ai/v1/memory/history/550e8400-e29b-41d4-a716-446655440000?limit=100&order=DESC" \
  -H "Content-Type: application/json"

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/history/' . $conversationId . '?limit=100&order=DESC';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Total messages: " . $data['total'];

curl -X GET "https://api.neuralcore5.ai/v1/memory/messages/search?sender_role=user&knowledge_tag=SHARED:GENERAL&limit=100" \
  -H "Content-Type: application/json"

<?php
$params = http_build_query([
    'sender_role' => 'user',
    'knowledge_tag' => 'SHARED:GENERAL',
    'limit' => 100
]);

$url = 'https://api.neuralcore5.ai/v1/memory/messages/search?' . $params;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['messages'] as $msg) {
    echo $msg['content'] . "\n";
}

{
  "success": true,
  "deleted_count": 3,
  "deleted_by": "cleanup-worker",
  "timestamp": "2025-11-11T15:45:30Z"
}

curl -X POST https://api.neuralcore5.ai/v1/memory/messages/bulk-delete \
  -H "Content-Type: application/json" \
  -d '{
    "message_ids": ["msg-1-uuid", "msg-2-uuid", "msg-3-uuid"],
    "deleted_by": "cleanup-worker"
  }'

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/messages/bulk-delete';

$payload = json_encode([
    'message_ids' => ['msg-1-uuid', 'msg-2-uuid', 'msg-3-uuid'],
    'deleted_by' => 'cleanup-worker'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Deleted " . $data['deleted_count'] . " messages";

curl -X GET "https://api.neuralcore5.ai/v1/memory/messages/unembedded?limit=100" \
  -H "Content-Type: application/json"

<?php
$url = 'https://api.neuralcore5.ai/v1/memory/messages/unembedded?limit=100';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['messages'] as $msg) {
    // Process message for embedding
    processEmbedding($msg['message_id'], $msg['content']);
}

curl -X PUT https://api.neuralcore5.ai/v1/memory/message/msg-550e8400-e29b-41d4-a716-446655440000/embedded \
  -H "Content-Type: application/json"

<?php
$messageId = 'msg-550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/message/' . $messageId . '/embedded';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if ($data['success']) {
    echo "Message marked as embedded";
}

curl -X GET "https://api.neuralcore5.ai/v1/memory/embedding-status?conversation_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json"

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/embedding-status?conversation_id=' . $conversationId;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Queue depth: " . $data['queue_depth'] . "\n";
echo "Processing: " . $data['processing_percentage'] . "%\n";

{
  "success": true,
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
  "participant": {
    "id": "new-participant-uuid-abc123",
    "type": "organic"
  },
  "timestamp": "2025-11-13T15:45:30Z"
}

curl -X POST https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000/participant \
  -H "Content-Type: application/json" \
  -d '{
    "id": "new-participant-uuid-abc123",
    "type": "organic"
  }'

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId . '/participant';

$payload = json_encode([
    'id' => 'new-participant-uuid-abc123',
    'type' => 'organic'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
    $data = json_decode($response, true);
    echo "Participant added: " . $data['participant']['id'] . "\n";
} else {
    echo "Error: HTTP " . $httpCode . "\n";
}

// 400 Bad Request - Missing conversation_id
{
  "success": false,
  "error": "conversation_id is required"
}

// 400 Bad Request - Invalid JSON payload
{
  "success": false,
  "error": "Invalid JSON payload",
  "message": "Syntax error"
}

// 400 Bad Request - Missing 'id' field
{
  "success": false,
  "error": "Missing required field",
  "field": "id"
}

// 400 Bad Request - Missing 'type' field
{
  "success": false,
  "error": "Missing required field",
  "field": "type"
}

// 400 Bad Request - Invalid participant type
{
  "success": false,
  "error": "Invalid type. Must be 'organic' or 'digital'"
}

// 500 Internal Server Error - Failed to add
{
  "success": false,
  "error": "Failed to add participant"
}

// 500 Internal Server Error - General error
{
  "success": false,
  "error": "Internal server error",
  "message": "[detailed error message]"
}

# Get active participants only (default)
curl -X GET "https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000/participants" \
  -H "Content-Type: application/json"

# Get all participants including inactive
curl -X GET "https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000/participants?active_only=false" \
  -H "Content-Type: application/json"

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';

// Get active participants only
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId . '/participants';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Active participants: " . $data['count'] . "\n";

foreach ($data['participants'] as $participant) {
    $status = $participant['active'] ? 'active' : 'inactive';
    echo "- {$participant['id']} ({$participant['type']}) - {$status}\n";
}

// Get all participants including inactive
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId . '/participants?active_only=false';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "\nTotal participants (including inactive): " . $data['count'] . "\n";

// 400 Bad Request - Missing conversation_id
{
  "success": false,
  "error": "conversation_id is required"
}

// 404 Not Found - Conversation not found
{
  "success": false,
  "error": "Conversation not found",
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000"
}

// 500 Internal Server Error
{
  "success": false,
  "error": "Internal server error",
  "message": "[detailed error message]"
}

curl -X DELETE https://api.neuralcore5.ai/v1/memory/conversation/550e8400-e29b-41d4-a716-446655440000/participant/participant-uuid-to-remove \
  -H "Content-Type: application/json"

<?php
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$participantId = 'participant-uuid-to-remove';
$url = 'https://api.neuralcore5.ai/v1/memory/conversation/' . $conversationId . '/participant/' . $participantId;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    echo "Participant removed successfully\n";
    echo "Timestamp: " . $data['timestamp'] . "\n";
} else if ($httpCode === 404) {
    echo "Participant not found or already removed\n";
} else {
    echo "Error: HTTP " . $httpCode . "\n";
}

// 400 Bad Request - Missing required parameters
{
  "success": false,
  "error": "conversation_id and participant_id are required"
}

// 404 Not Found - Participant not found or already removed
{
  "success": false,
  "error": "Participant not found or already removed",
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
  "participant_id": "participant-uuid-to-remove"
}

// 500 Internal Server Error
{
  "success": false,
  "error": "Internal server error",
  "message": "[detailed error message]"
}

curl -X GET "https://api.neuralcore5.ai/v1/organic-people/1234567/conversations?type=digital&limit=50" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X GET "https://api.neuralcore5.ai/v1/organic-people/1234567/conversations/conv_abc123xyz456?include_raw=false" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

<?php
$opid = '1234567';
$conversationId = 'conv_abc123xyz456';
$url = "https://api.neuralcore5.ai/v1/organic-people/$opid/conversations/$conversationId";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Conversation: " . $data['conversation']['title'] . "\n";
echo "Messages: " . $data['message_count'] . "\n";

foreach ($data['messages'] as $msg) {
    $sender = ($msg['sender_type'] === 'opid') ? 'User' : 'Assistant';
    echo "$sender: " . $msg['content'] . "\n";
}

{
  "success": true,
  "opid": "1234567",
  "query": "payment invoice",
  "total_results": 15,
  "results": [
    {
      "conversation_id": "conv_abc123xyz456",
      "conversation_title": "Billing Support",
      "message_id": "msg_xyz789",
      "sender_type": "opid",
      "sender_id": "1234567",
      "content": "Can you send me my payment invoice for last month?",
      "created_on": "2025-11-05T14:22:00Z",
      "relevance_score": 0.95
    },
    {
      "conversation_id": "conv_def456ghi789",
      "conversation_title": "Account Questions",
      "message_id": "msg_abc456",
      "sender_type": "opid",
      "sender_id": "1234567",
      "content": "I need a copy of the invoice for my recent payment.",
      "created_on": "2025-11-02T09:15:00Z",
      "relevance_score": 0.89
    }
  ]
}

curl -X POST https://api.neuralcore5.ai/v1/organic-people/1234567/conversations/search \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "payment invoice",
    "date_from": "2025-11-01T00:00:00Z",
    "limit": 50
  }'

{
  "success": true,
  "export_id": "export_abc123xyz456",
  "format": "pdf",
  "conversation_id": "conv_abc123xyz456",
  "file_url": "https://api.neuralcore5.ai/exports/conv_abc123xyz456.pdf",
  "file_size_bytes": 524288,
  "expires_at": "2025-11-12T18:30:00Z",
  "generated_at": "2025-11-11T18:30:00Z",
  "message": "Export ready for download. Link expires in 24 hours."
}

curl -X POST https://api.neuralcore5.ai/v1/organic-people/1234567/conversations/conv_abc123xyz456/export \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "pdf",
    "include_metadata": true
  }'

curl -X GET "https://api.neuralcore5.ai/v1/organic-people/1234567/conversations/statistics?period=month" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "success": true,
  "opid": "1234567",
  "person": {
    "opid": "1234567",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "+15127563382",
    "birth_date": "1990-01-15",
    "address": {
      "line1": "123 Main Street",
      "line2": "Apt 4B",
      "city": "Austin",
      "state": "TX",
      "postal": "78701",
      "country": "US"
    },
    "rank": "subscriber",
    "status": "active",
    "created_at": "2025-11-11T18:00:00Z",
    "updated_at": "2025-11-11T18:00:00Z"
  },
  "message": "Organic person created successfully"
}

curl -X POST https://api.neuralcore5.ai/v1/organic-people/create \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "+15127563382"
  }'

curl -X GET https://api.neuralcore5.ai/v1/organic-people/1234567 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "success": true,
  "opid": "1234567",
  "updated_fields": ["email", "phone", "rank", "address"],
  "person": {
    "opid": "1234567",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe.updated@example.com",
    "phone": "+15129876543",
    "rank": "premium",
    "updated_at": "2025-11-11T18:15:00Z"
  },
  "message": "Organic person updated successfully"
}

curl -X PUT https://api.neuralcore5.ai/v1/organic-people/1234567 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john.doe.updated@example.com",
    "rank": "premium"
  }'

curl -X DELETE "https://api.neuralcore5.ai/v1/organic-people/1234567?hard_delete=false" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "success": true,
  "total": 127,
  "limit": 50,
  "offset": 0,
  "results": [
    {
      "opid": "1234567",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "phone": "+15127563382",
      "rank": "subscriber",
      "status": "active",
      "created_at": "2025-11-11T18:00:00Z"
    },
    {
      "opid": "2345678",
      "first_name": "Johnny",
      "last_name": "Smith",
      "email": "johnny.smith@example.com",
      "phone": "+15129876543",
      "rank": "subscriber",
      "status": "active",
      "created_at": "2025-11-10T14:30:00Z"
    }
  ]
}

curl -X POST https://api.neuralcore5.ai/v1/organic-people/search \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "john",
    "rank": "subscriber",
    "limit": 50
  }'

{
  "success": true,
  "rule_id": "mod_abc123xyz456",
  "opid": "1234567",
  "rule": {
    "rule_id": "mod_abc123xyz456",
    "field_name": "email",
    "current_value": "old.email@example.com",
    "proposed_value": "john.doe@example.com",
    "reason": "outdated",
    "severity": "high",
    "status": "pending",
    "notes": "User reported email change via support ticket #12345",
    "reported_by": "support_team",
    "created_at": "2025-11-11T19:00:00Z",
    "reviewed_at": null,
    "reviewed_by": null
  },
  "message": "Moderation rule created successfully"
}

curl -X POST https://api.neuralcore5.ai/v1/organic-people/1234567/moderate/rules \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "field_name": "email",
    "current_value": "old.email@example.com",
    "proposed_value": "john.doe@example.com",
    "reason": "outdated",
    "severity": "high"
  }'