AEGIS OpenAPI Specification

openapi: 3.1.0
info:
  title: AEGIS Threat Intelligence API
  description: Advanced threat assessment and risk prediction for GCTI AEGIS Platform
  version: 1.0.0
servers:
  - url: https://sentinel-hub-gcti-dtm.base44.app
    description: AEGIS Production Server
paths:
  /aegis/risk-assessment:
    post:
      operationId: predictRiskAssessment
      summary: Generate terrorism risk assessment
      description: Analyzes individual, organizational, geographic, or event-based threat profiles using AEGIS DTM framework
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - target_entity
                - assessment_type
              properties:
                target_entity:
                  type: string
                  description: Entity being assessed
                assessment_type:
                  type: string
                  enum: [individual, organization, geographic, event]
                  description: Type of risk assessment
                factors:
                  type: object
                  description: Risk factor scores 0-100
                  properties:
                    SES:
                      type: number
                      description: Socioeconomic Status
                    PI:
                      type: number
                      description: Political Ideology
                    IE:
                      type: number
                      description: Ideological Extremism
                    SD:
                      type: number
                      description: Social Disconnection
                    LE:
                      type: number
                      description: Law Enforcement History
                    PSF:
                      type: number
                      description: Psychological Factors
                    EI:
                      type: number
                      description: External Influences
                location:
                  type: object
                  properties:
                    latitude:
                      type: number
                    longitude:
                      type: number
                    region:
                      type: string
                context:
                  type: string
                  description: Additional assessment context
      responses:
        "200":
          description: Successful risk assessment
          content:
            application/json:
              schema:
                type: object
                properties:
                  risk_assessment_id:
                    type: string
                  terrorism_risk_score:
                    type: number
                    description: Composite risk score 0-100
                  risk_level:
                    type: string
                    enum: [negligible, low, moderate, high, critical]
                  confidence_score:
                    type: number
                    description: Model confidence 0-1
                  contributing_factors:
                    type: array
                    items:
                      type: string
                  mitigation_recommendations:
                    type: string
                  expires_date:
                    type: string
                    format: date-time
                  generated_at:
                    type: string
                    format: date-time