Link entities

Server: https://{kibana_url}

POST /api/security/entity_store/resolution/link
POST /s/{space_id}/api/security/entity_store/resolution/link

Refer to Spaces for more information.

Link one or more entities to a target entity, creating a resolution group. Changes become visible on subsequent reads after the next index refresh (typically <1s).

[Required authorization] Route required privileges: securitySolution AND securitySolution-entity-analytics.

Request

Responses

200

Indicates a successful response.

application/json

400

Bad request.

application/json

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST kbn://api/security/entity_store/resolution/link
{
  "target_id": "user:jane.doe@example.com",
  "entity_ids": ["user:jdoe@example.com"]
}

curl Shell

curl -X POST -H "kbn-xsrf: true" -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"target_id":"user:jane.doe@example.com","entity_ids":["user:jdoe@example.com"]}' \
  "${KIBANA_URL}/api/security/entity_store/resolution/link"

Response

{
  "error": "Bad Request",
  "message": "Cannot link entities of different types",
  "statusCode": 400
}

Link two user entities to a target entity, creating a resolution group.