Skip to main content
POST
/
v2
/
prioritize
Deterministic environment-aware signal prioritization
curl --request POST \
  --url https://api.kyberis.ai/v2/prioritize \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "environment": {
    "capabilities": [
      "<string>"
    ],
    "cloud_providers": [
      "<string>"
    ],
    "external_exposure": [
      "<string>"
    ],
    "geography": [
      "<string>"
    ],
    "hosting_model": "<string>",
    "industry": "<string>",
    "products": [
      "<string>"
    ],
    "vendors": [
      "<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>"
    ]
  },
  "expected_categories": [],
  "include_debug": false,
  "max_items": 20,
  "seen_signal_ids": [
    "<string>"
  ],
  "seen_since": "2023-11-07T05:31:56Z",
  "time_window_days": 30
}
'
{
  "generated_at": "<string>",
  "items": [
    {
      "confidence_score": 0.5,
      "environment_match_reasons": [
        "<string>"
      ],
      "freshness_score": 0.5,
      "is_new_to_requester": true,
      "novelty_score": 0.5,
      "priority_score": 0.5,
      "recommended_action_summary": "<string>",
      "signal_id": "<string>",
      "supporting_evidence": [
        {
          "evidence_id": "<string>",
          "evidence_type": "<string>",
          "published_at": "<string>",
          "source": "<string>"
        }
      ],
      "suppression_reasons": [
        "<string>"
      ],
      "title": "<string>",
      "what_changed": [
        "<string>"
      ],
      "debug": {},
      "first_seen": "<string>",
      "last_seen": "<string>"
    }
  ],
  "meta": {
    "candidate_count": 1,
    "implemented_categories": [],
    "ranked_count": 1,
    "requested_categories": [],
    "truncated": true,
    "unimplemented_categories": [],
    "budget": {
      "candidate_limit_per_category": 2,
      "candidate_limit_total": 2,
      "report_ids_per_candidate": 2,
      "supporting_reports_per_item": 2
    }
  },
  "window_end": "<string>",
  "window_start": "<string>"
}

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
PrioritizeEnvironment · object
required
agent_context
AgentContext · object
expected_categories
enum<string>[] | null
Available options:
vulnerability,
campaign,
actor_activity,
malware_activity,
ioc_cluster,
technique_cluster,
identity_abuse,
vendor_risk_cluster
include_debug
boolean
default:false
max_items
integer
default:20
Required range: 1 <= x <= 100
seen_signal_ids
string[] | null
Maximum array length: 500
Maximum string length: 128
seen_since
string<date-time> | null
time_window_days
integer
default:30
Required range: 1 <= x <= 180

Response

Successful Response

generated_at
string
required
items
PrioritizeItem · object[]
required
meta
PrioritizeMeta · object
required
window_end
string
required
window_start
string
required