API ReferenceRisk
Assess Risk
Score a synthetic authentication event without side effects.
Endpoint
POST /v1/risk:assessBase URL: https://<Domain id="api"/>
Authentication: Bearer token with risk:write.
Request
{
"identity_id": "usr_4f18acec",
"organization_id": "org_7a2b3c4d",
Example
body := strings.NewReader(`{
"identity_id":"usr_4f18acec",
"event_type":"login",
"context":{"ip":"198.51.100.42","user_agent":"Mozilla/5.0"}
}`)
req, _ := http.NewRequest("POST",
import httpx, os
res = httpx.post(
"https://api-id.avnology.net/v1/risk:assess",
json={
"identity_id": "usr_4f18acec",
"event_type": "login",
"context"
curl -X POST "https://api-id.avnology.net/v1/risk:assess" \
-H "Authorization: Bearer $AVNOLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"identity_id": "usr_4f18acec",
"event_type": "login",
"context": {
"ip": "198.51.100.42",
"user_agent": "Mozilla/5.0"
}
}'body := strings.NewReader(`{
"identity_id":"usr_4f18acec",
"event_type":"login",
"context":{"ip":"198.51.100.42","user_agent":"Mozilla/5.0"}
}`)
req, _ := http.NewRequest("POST",
import httpx, os
res = httpx.post(
"https://api-id.avnology.net/v1/risk:assess",
json={
"identity_id": "usr_4f18acec",
"event_type": "login",
"context"
curl -X POST "https://api-id.avnology.net/v1/risk:assess" \
-H "Authorization: Bearer $AVNOLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"identity_id": "usr_4f18acec",
"event_type": "login",
"context": {
"ip": "198.51.100.42",
"user_agent": "Mozilla/5.0"
}
}'body := strings.NewReader(`{
"identity_id":"usr_4f18acec",
"event_type":"login",
"context":{"ip":"198.51.100.42","user_agent":"Mozilla/5.0"}
}`)
req, _ := http.NewRequest("POST",
import httpx, os
res = httpx.post(
"https://api-id.avnology.net/v1/risk:assess",
json={
"identity_id": "usr_4f18acec",
"event_type": "login",
"context"
curl -X POST "https://api-id.avnology.net/v1/risk:assess" \
-H "Authorization: Bearer $AVNOLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"identity_id": "usr_4f18acec",
"event_type": "login",
"context": {
"ip": "198.51.100.42",
"user_agent": "Mozilla/5.0"
}
}'body := strings.NewReader(`{
"identity_id":"usr_4f18acec",
"event_type":"login",
"context":{"ip":"198.51.100.42","user_agent":"Mozilla/5.0"}
}`)
req, _ := http.NewRequest("POST",
import httpx, os
res = httpx.post(
"https://api-id.avnology.net/v1/risk:assess",
json={
"identity_id": "usr_4f18acec",
"event_type": "login",
"context"
Response (200 OK)
See the model in Risk. recommended_action values: ALLOW, REQUIRE_MFA, REQUIRE_STEP_UP, BLOCK.