Skip to main content
POST
/
v2
/
environment-assessments
Structured environment assessment (LLM-free)
curl --request POST \
  --url https://api.kyberis.ai/v2/environment-assessments \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "environment_context": {
    "crown_jewel_asset_count": 25000,
    "detection_coverage": 0.5,
    "eol_asset_count": 25000,
    "externally_exposed_service_count": 100000,
    "mfa_enforced": true,
    "patch_latency_days": 182,
    "regions": [
      "<string>"
    ],
    "sector": "<string>"
  },
  "agent_context": {
    "objective": "<string>",
    "requested_outcome": "<string>",
    "run_id": "<string>",
    "step_id": "<string>",
    "client": {
      "agent_name": "<string>",
      "agent_version": "<string>",
      "framework": "<string>"
    },
    "constraints": {
      "latency_budget_ms": 15025,
      "max_results_budget": 100,
      "min_resolution_confidence": 0.5,
      "strict_mode": true
    },
    "parent_step_id": "<string>",
    "tags": [
      "<string>"
    ]
  },
  "context": {
    "affected_cpes": [
      "<string>"
    ],
    "campaign_status": "<string>",
    "evidence_refs": [
      {
        "id": "<string>",
        "type": "<string>"
      }
    ],
    "intel_confidence": "<string>",
    "known_exploited": true,
    "known_targets": [
      "<string>"
    ],
    "targeted_industries": [
      "<string>"
    ],
    "targeted_regions": [
      "<string>"
    ]
  },
  "environment": "<string>",
  "expected_types": [
    "<string>"
  ],
  "options": {},
  "query": "<string>",
  "resolution": {
    "include_aliases": false,
    "include_metadata": false,
    "max_results": 5
  },
  "subject": {
    "canonical_id": "<string>",
    "entity_type": "<string>",
    "canonical_name": "<string>"
  },
  "time_range": {}
}
'
{
  "assessment_type": "<string>",
  "caveats": [
    "<string>"
  ],
  "confidence": 123,
  "evidence_refs": [
    {}
  ],
  "input": {},
  "metadata": {},
  "priority": {},
  "rationale_codes": [
    "<string>"
  ],
  "recommended_actions": [
    "<string>"
  ],
  "resolution": {
    "candidates": [
      {
        "canonical_id": "<string>",
        "canonical_name": "<string>",
        "entity_type": "<string>",
        "match_type": "<string>",
        "score": 123,
        "aliases": [
          "<string>"
        ],
        "matched_on": "<string>",
        "metadata": {}
      }
    ],
    "canonical_id": "<string>",
    "canonical_name": "<string>",
    "entity_type": "<string>",
    "resolution_confidence": 123
  },
  "signals": {},
  "timestamp": 123,
  "trace_id": "<string>",
  "debug": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.kyberis.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

ApiKey <key_id>:

Body

application/json
environment_context
EnvironmentContext · object
required
agent_context
AgentContext · object
context
AssessmentContext · object
environment
string | null
expected_types
string[] | null
options
Options · object
query
string | null
Maximum string length: 1024
resolution
ResolutionOptions · object
subject
AssessmentSubject · object
time_range
Time Range · object

Response

Successful Response

assessment_type
string
required
caveats
string[]
required
confidence
number
required
evidence_refs
Evidence Refs · object[]
required
input
Input · object
required
metadata
Metadata · object
required
priority
Priority · object
required
rationale_codes
string[]
required
resolution
ResolutionResult · object
required
signals
Signals · object
required
timestamp
number
required
trace_id
string
required
debug
Debug · object