Resolution Responses - Developer Portal

Entity resolution answers what a raw input refers to in Kyberis.

Response Envelope

/v2/entity-resolution returns:

Field	Meaning
`input`	Normalized echo of the submitted query and requested type constraints.
`resolution`	Resolution result object containing status, canonical entity details, candidates, and confidence fields.

Batch resolution responses use the standard batch envelope described in Batch responses.

Status Values

Status	Meaning	Agent action
`resolved`	Kyberis found a canonical entity.	Continue with `canonical_id` and `entity_type`.
`ambiguous`	Multiple candidates are plausible.	Ask for disambiguation or retry with tighter `expected_types`.
`not_found`	No canonical entity matched.	Stop or pivot to a different enrichment path.

Key Fields

canonical_id
canonical_name
entity_type
resolution_confidence
candidates[]
match_type
score
aliases and metadata when requested

Common Mistakes

Do not guess when status is ambiguous.
Do not continue to assessment when status is not_found unless you intentionally switch to query mode.
Do not use ioc as an expected type. Use ip, domain, url, hash, or email.

⌘I